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Preface 


This manual explains how to use the pfs:REPORT 
program to produce tabular reports from the 
information stored in your pfs: files. It assumes that 
you already know how to use pfs:FILE to create files, 
and that you are familiar with the general operation of 
your IBM Personal Computer. If you have not used 
pfs: FILE before, we suggest that you read through the 
Dfs:FILE manual and work its examples before 
continuing. Similarly, if you are not comfortable with 
basic operating procedures for your computer, refer to 
the IBM Guide to Operations for help. 


To use REPORT, you need an IBM Personal Computer 
with at least 64KB of memory, one diskette drive, a 
printer, IBM’s Disk Operating System (DOS), the 
REPORT program diskette, and the pfs: file you want 
to use to generate a report. You must have a second 
diskette drive to take full advantage of REPORT'’s 
capabilities. 


This manual contains five chapters and four 
appendixes. The chapters give you detailed, step-by- 
step instructions on how to use REPORT. The 
appendixes include information on error messages and 
recovery, useful DOS commands, and instructions for 
setting up various printers. In addition, there isa 
Quick Reference Card that summarizes the most 
important and most used information. 


IMPORTANT: The REPORT program diskette contains 
the example file, named STAFF, that is used throughout 
this manual. Before trying to follow the examples, you 
should use the DOS COPY function to copy the STAFF 
file onto a blank formatted diskette (see “Copying a 
File’ and ‘“‘Formatting Diskettes”’ in Appendix C). 
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Introduction 


This Introduction consists of two parts: 


e ~—s- Part I. Getting Ready to Use pfs: REPORT 
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es Part Il. The pfs: REPORT Program 


The first part explains what you need to do before you 
can begin to use the pfs:REPORT program. This part 
includes instructions for preparing the program 
diskette for daily use, and making a spare or “‘back- 
up’ copy of it. It is important that you complete these 
instructions before using the program diskette for the 
first time. 


The second part gives you an overview of the 
Dfs:REPORT program and how it works. You will also 
learn about special keys on your IBM Personal 
Computer that make it easier for you to work with the 
program. It is a good idea to read this part over before 
beginning to use REPORT. 
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Part I. Getting Ready to Use REPORT 


What you Need to use REPORT 
IBM Monochrome Display 


On-Off 
Switch 


Keyboard 


IBM 80 CPS 
Matrix Printer 


To use REPORT, you need: 


e anIBM Personal Computer with at least 64KB of 
memory 


e One or two diskette drives, preferably two 


e anIBM Monochrome Display or other 80-column 
video monitor 


e one of the following printers: 


— the IBM 80 CPS Matrix Printer or another 
parallel printer plugged into the IBM 
Monochrome Display and Parallel Printer 
Adapter 


— The IBM 80 CPS Matrix Printer or another 
parallel printer plugged into an IBM Parallel 
Printer Adapter 
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—  aserial printer connected with the IBM 
Asynchronous Communications Adapter 


e the pfs:REPORT program diskette 
e the IBM Disk Operating System (DOS) 


e asupply of blank formatted diskettes 


Making the REPORT Program Diskette 
Self-Loading 


Before you begin using REPORT, you should modify 
the program diskette so that it is self-loading, i.e., so 


that you can load REPORT without first loading DOS. 


To modify the diskette, follow these instructions: 

For a two-drive system: 

1. First, remove the write-protect tab from the 
REPORT diskette and save it for later use. Then 
insert the DOS diskette into drive A and turn on 


your IBM Personal Computer. 


2. Enter the date (and time if requested) when DOS 
asks you to do so. 


3. When the DOS prompt (A>) appears, place the 


pass 
= 
= 
o) 
a 
on 
Q | 
eo 
peta 
o | 
— 


REPORT diskette in drive A and the DOS diskette in 


drive B. Type: 


INSTALL 


and press the Enter key. 
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4. When the computer displays the message: 


PAUSE-Place your DOS diskette in drive “B” and 
leave the PFS series diskette in drive “A” 
Strike a key when ready... 


press any key. You will see a series of DOS 
commands and the in-use lights of the diskette 
drives will come on alternately for the next few 
moments as information is copied from the DOS 
diskette to the REPORT diskette. 


5. When the DOS prompt reappears, go to the next 
section, ‘‘Making a Backup Copy of the REPORT 
Program Diskette,’ to make a one-time backup 
copy of your REPORT program diskette. 


For a one-drive system: 


1. First, remove the write-protect tab from the 
REPORT diskette and save it for later use. Then 
insert the DOS diskette into the drive and turn on 
your IBM Personal Computer. 


2. Enter the date (and time if requested) when DOS 
asks you to do so. 


3. When the DOS prompt (A >) appears, place the 
REPORT diskette in the drive, type: 


INSTALL 
and press the Enter key. 

4. The computer displays the message : 
PAUSE-Place your DOS diskette in drive “B” and 
leave the PFS series diskette in drive “A” 


Strike a key when ready... 


With the REPORT diskette still in the drive, press 
any key to continue. 


Note: In the instructions that follow, remember to 
insert the DOS diskette in the drive when the 
computer asks for drive B. Insert the REPORT diskette 
in the drive when the computer asks for drive A. 


ez 
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When the computer displays the message : 


Insert diskette for drive B 
and strike any key when ready 


insert the DOS diskette in the drive and press a key. 


. When the computer displays the message: 


Insert diskette for drive A 
and strike any key when ready 


insert the REPORT diskette in the drive and press a 
key. 


. Continue inserting the REPORT diskette when the 


computer asks for a diskette for drive A, and the 
DOS diskette when the computer asks for a diskette 
for drive B, until the DOS prompt (A>) reappears. 


. Now go to the next section, “Making a Backup 


Copy of the REPORT Program Diskette,”’ to make a 
one-time backup copy of your REPORT program 
diskette. 


Making a Backup Copy of the REPORT 
Program Diskette 


Before you use the REPORT program, you should 
make a backup copy of the program diskette. You can 
only make a copy of the program diskette once, so 
follow the instructions below very carefully. Also, if 
you haven’t followed the instructions in the previous 
section, “Making the REPORT Program Diskette Self- 
Loading’ do so now before attempting to back up 
your REPORT diskette. 
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For a two-drive system: 


1. Place the REPORT diskette in drive A, and type: 


BACKUP 


and press the Enter key. Several DOS 
commands will be displayed, then the following 
screen will appear: 


PFS SERIES PROGRAM BACKUP UTILITY 


Have your PFS series program diskette and a blank, 
DOUBLE DENSITY, HIGH QUALITY diskette ready. 
Remove the write-protect tab from each diskette. 

Place the blank diskette in drive B and press F10 when ready. 

If you are not ready for this operation, turn the machine off. 
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2. Place a high quality, blank diskette in drive B (leave 
the REPORT diskette in drive A) and press the 
key. The diskette is being initialized while 
the “Working. .”’ message is on the screen. When 
the “Copying. .”’ message is on the screen, the 
backup procedure is under way. 


3. When the DOS prompt (A>) reappears with a 
cursor, remove both diskettes and place a write- 
protect tab on each of them. Label the backup copy 
with a felt-tipped pen. Work with the copy and 
store the original REPORT diskette in a safe place. 
You are now ready to begin using the REPORT 
program. 


WwW 


For a one-drive system: 


1. Place the REPORT diskette in the drive, and type: 


jee 
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BACKUP 


and press the Enter key. After several DOS 
commands are displayed the following screen will 
appear: 


PFS SERIES PROGRAM BACKUP UTILITY 


Have your PFS series program diskette and a blank, 
DOUBLE DENSITY, HIGH QUALITY diskette ready. 
Remove the write-protect tab from each diskette. 

Place the blank diskette in drive A and press F10 when ready. 
If you are not ready for this operation, turn the machine off. 
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2. Place a high quality, blank diskette in the drive and 
press(F19). The diskette is being initialized while the 
“Working. .”’ message is on the screen. 


3. When requested, place your REPORT diskette in the 


drive and press(F10). 


4. When requested, replace the REPORT diskette with 
the blank diskette again, and press (F 19). 


5. When the computer asks you to insert a diskette for 
drive A, insert the REPORT diskette. 
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When the computer asks you to insert a diskette 
for drive B, insert the blank diskette. 


Continue switching the two diskettes when 
requested. Be prepared to switch the diskettes 
20-25 times. A series of DOS command lines will 
appear as you go through this process. When the 
DOS prompt reappears, remove the last diskette 
from the drive, and place a write-protect tab on 
both diskettes. Label the backup copy with a felt- 
tipped pen. Work with the copy and store the 
original REPORT diskette in a safe place. You are 
now ready to begin using the REPORT program. 


Starting REPORT When the Computer 
is Off 


To load the REPORT program into your IBM Personal 
Computer, follow these steps: 


L, 


Insert the REPORT program diskette in drive A 
and turn on your IBM Personal Computer. 


Enter the new date and time when DOS prompts 
you to do so. 


At this point, you will hear the diskette drive 
loading REPORT, then the REPORT Main Menu 
will appear on the screen. Remove the program 
diskette from the drive and put it back in its 
envelope. You won't need it again until you want 
to exit from REPORT. 


Starting REPORT When the Computer 
is On 


When you have been using DOS or running other 
programs, you can switch easily to REPORT: 


iF 


Make sure you have exited from your program. 
The last item on the screen should be the DOS 
prompt: 


A> 


2. Remove any diskettes from the drives and put 
REPORT into drive A. 


3. Type in the word REPORT and press the Enter 
key. The REPORT program will load into the 
computer and the Main Menu will appear. You are 
now ready to begin using REPORT. You can take the 
REPORT diskette out and store it in its envelope. 


Using REPORT With a One-Drive 
System 


While it is possible to use REPORT with only one 
diskette drive, you will not be able to sort lengthy 
reports. REPORT needs temporary work space on the 
diskette in the work drive in order to sort a report. For 
a One-drive system, the work drive should be drive A. 
To set the work drive to drive A, run the SETUP 
program described in “Setting up a Serial Printer and 
the Work Drive” in Appendix D. Also, some examples 
in this manual ask you to put a blank formatted 
diskette in drive B. Instead, make sure that the diskette 
in the drive has free space at least equal to the size of 
the data file you are sorting. 
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Protecting Your pfs: Data Files 


By the time you have created a pfs: file and entered 
the information in it, you have invested a good deal of 
your time. To avoid losing the data stored in that file 
(and the time you've spent entering it), follow these 
guidelines: 


1. Never remove a data diskette or turn the IBM 
Personal Computer off unless the pfs: REPORT 
Main Menu is displayed on the screen. If you do, it 
may damage your file. 


2. Use only high-quality diskettes. 
3. Always keep at least one extra, or “backup copy” of 


each pfs: file. See our backup recommendations 
below. 
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Handle your diskettes carefully. Store away from 
heat, sunlight, and devices with strong magnetic 
fields (TVs, diskette drives, etc.) 


Print a copy of your files from time to time. See 
Chapter 5 of the pfs:FILE Manual for 
instructions. 


Recommended Backup Procedure 


iF 


Back up your files on a regular basis. If you 
update them daily, then back up daily. If you 
update less often, then back up whenever you 
update. 


Make two backup copies initially, and alternate 
the use of them. The first time you back up, use 
the first diskette; the next day, use the other 
diskette; and so on. This way, if a problem 
develops while making a backup, you will still 
have the data on the other backup diskette. 


If you have two diskette drives, back up your files 
by using the pfs:FILE COPY function. If you have 
only one drive, use the DOS COPY program (see 
“Copying a File” in Appendix C, or your DOS 
manual for details). 


If you encounter problems with a file or get an I/O 
ERROR message, discard the diskette at once 

and use the backup diskette (make a copy of the 
backup diskette first). If the problem recurs with 
the backup diskette, ask your IBM Personal 
Computer dealer for help. 


Part II. The pfs:REPORT Program 
What is pfs: REPORT? 


Often, you need to summarize the information stored 
in a pfs: file, and present it in the form of a table. 
Dfs:REPORT prepares and prints tabular reports, 
according to your specifications, from the information 
stored in a pfs: file. You work with REPORT in much 
the same way as you work with pfs:FILE by choosing 
items listed on a series of menus, and by entering 
simple instructions into the blank form from the pfs: 
file. In fact, if you know how to use pfs:FILE, you 
already know a lot about how to use pfs: REPORT. 


Sosa 
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Each report that you produce with REPORT is a table 
consisting of up to 16 vertical columns and an 
unlimited number of rows. Each column corresponds 
to an item in your pfs: file, and each row contains the 
information from a single form. REPORT can sort the 
rows alphabetically or numerically, and can do 
calculations with numerical information printed either 
in columns or rows. 


Suppose you have the purchase history of all the items 
in your inventory stored ina pfs: file. The blank form 
might look like this: 


File: parts RETRIEVE SPEC Page 1 
F10-continue 
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000000 0 0 0 
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You might like to print a report such as the one shown 
below, that lists all items purchased in the last month: 


Inventory Additions—3/12/81 
Description Quantity Price Supplier 


"lag bolts = Johnson Mfg. 
cedar shingles * Roof tex 
4 inch bricks 3000 - Brickmart 
ceramic tile 600 = Tilecomp 


000000 0 0 0 


This is a fairly simple report. The title line, “Inventory 

Additions- 3/12/81’, will appear at the top of each page Nea 
in the report. Each row gives information from one 

form in the file, and the rows are sorted numerically 

by part number. As you can see, the column headings 

match the item names. Notice that REPORT has laid 

out the report to take best advantage of the available 


space. 


You might also like to print a report to show the parts 
currently in stock, including the total number of 
items: 


Parts in Stock 

Description 

"lag bolts 
cedar shingles 


4 inch bricks 
ceramic tile 


In this example, REPORT counted the entries in the 
first column to give you the number of different parts 
in stock. REPORT can total, average, or count the 
number of entries in a column. It can also give 
subtotals, subaverages, and subcounts. 


Finally, you might want to print a report to calculate 
the total value of the parts currently in your inventory: 
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Total Value of Inventory 
Description Quantity 


" lag bolts 
cedar shingles 4,000 
4 inch bricks 3,000 
ceramic tile 600 


In this report, REPORT calculated the VALUE column 
by multiplying the values from the PRICE and 
QUANTITY columns. You can have up to three such 
“derived” columns in a report. 


When designing a report, you sometimes want to 
change the column names to be something other than 
the item names. This is especially desirable when an 
item name is too long to fit in the width REPORT 
allows for the column. REPORT makes it easy to 
change any column heading in the report. For 
example, in any of the above reports, you could 
change QUANTITY to QTY. 


If you want to use the same report design more than 
once (quite common), you can store the design for 
future use. You can store up to eight report designs for 
each pfs: file. For example, you could store the 
designs for the three reports shown above and use 
them to print regular, periodic reports on inventory 
status. 


Using pfs: Files 


You can prepare reports from pfs: files stored on any 
DOS-compatible diskette drive connected to your IBM 
Personal Computer. You tell REPORT which drive 
contains the file by including the drive name as part of 
the file name. The drive name comes first, then a 
colon, then the file name (including any extension 
assigned as part of the name when you created the 
file). For example, B:STAFF refers to the file named 
STAFF that is stored on the diskette in drive B. If you 
do not include a drive name, REPORT assumes the file 
is stored on the diskette in the default drive (drive A 
unless you have changed it.) The section “Specifying 
the Default Drive” in your Disk Operating System 
(DOS) manual describes the default drive. Therefore, 
the file name STAFF refers to a file named STAFF that is 
stored on the diskette in drive A. 
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Special Keys 


Before you begin to use REPORT, take a look at the 
IBM keyboard. 
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I-17 


I-18 


You use the same special keys when working with 
REPORT as when working with pfs:FILE. These keys 
are: 


Control. Use the key together with 
other keys to give special instructions to 
REPORT. For example, when you see 


, it means to press and, while 
holding it down, press 


(5) Escape. Use the key at any point while 


you are using REPORT to cancel the 
current operation and return to the Main 
Menu. 


Tab. The key moves the cursor 
from one item to the next on a menu or 
pfs:FILE form. With the Shift key (2). 
it moves the cursor back to the previous 
item. 


Backspace. The key moves the cursor 
one space to the left and removes any 
character in that space. Use this key to 
correct mistakes you make when filling in 
items on the screen. 


Enter. The key returns the cursor to 
the beginning of the next line. 


Print Screen. Use the key with Shift 
to print a copy of whatever is currently 
on the screen. 


Number Lock. Press the key to 
convert the section of keys at the right of 
the main keyboard into a numeric keypad. 


WO 


Cursor Movement Keys. These keys move 
the cursor one space in the direction 
shown by the arrow. They do not erase 
any characters. (When you press the 

key, these keys become part of the 
numeric keypad. Press again to 
return to the cursor movement keys.) 


ie 
hu 
| rs 


Page Down. The key brings up the 
next page of a multi-page form. 


Page Up. The key brings up the 
previous page of a multi-page form. 


The following special function keys, located to the left 
of the main keyboard, are available for use when the 
key name appears on the bottom line of the screen: 


removes a previously-defined 
report specification (Chapter 2 discusses 
pre-defined report specifications). 


F3 


J 
faa 


switches between the main report 
specification screen and the derived 
column specification screen. 


begins (or continues) the specified 
function. 


IBpe 
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The pfs: REPORT Menu 


The REPORT Menu lists the four main functions of the 
REPORT program: 


PFS:REPORT 


PRINT A REPORT 


PRE-DEFINE A REPORT 


SET NEW HEADINGS 


EXIT PFS:REPORT 


© 1982 Software Publishing Corporation 
© 1982 International Business Machines Corporation 
0450000000 F10-continue 


You will see this menu whenever you load the 
REPORT program, when you complete a given 
operation, and whenever you press the key. 
After loading REPORT and before pressing any key, the 
copyright notices appear at the bottom of the screen. 
If your REPORT program diskette is serialized, a serial 
number also appears at the bottom left of the screen. 
You select functions from the menu by filling in the 
two highlighted items: 


SELECTION NUMBER Enter the number that 
corresponds to the function 
you want to choose. 


FILE NAME Enter the name of your pfs: 
file. This can be a simple file 
name, such as STAFF or it can 
include the drive name and 
file name, such as B:STAFE If 
no drive is specified, REPORT 
assumes that the file is in the 
default drive (usually drive A). 


wy 


When you have filled in both items, press(F18) to begin 
the specified function. 


Summary 
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pfs:REPORT is a computer program that 
prepares and prints reports from the information 
stored in a pfs: file 


To use REPORT, you need the following: 


— an IBM Personal Computer with at least 
64 KB of memory 


— anIBM Monochrome Display or other 
80-column video monitor 


— one or (preferably) two diskette drives 


— aprinter 


F10 Tells REPORT to begin (or continue) 
the specified function 


(ee) cancels the current function and 
returns to the Main Menu 


moves the cursor to the next item on 
a menu or form 


moves the cursor one space to the 
left and erases any character in that 
position 


Tum converts the keys on the right of the 
main keyboard into a numeric 
keypad. 
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move the cursor one space in the 
direction shown by the arrow. When 
you press , these become part of 
the numeric keypad. 


with SHIFT (ft) , prints a copy of 
whatever is on the screen. 
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Chapter 1. Print A Report 


This chapter explains how to use the PRINT A REPORT 
function to prepare and print a report from a pfs: file. 
The first part of the chapter describes the three steps 
necessary to print a report; it shows sample reports 
that might result from the choices that are discussed. 
Following that, there is an example for you to follow 
that includes step-by-step instructions for preparing a 
typical report from the file provided on the REPORT 
program diskette. The remainder of the chapter 
discusses the special options that can be included as 
part of the final step, including an example of each 
option for you to try. 


The PRINT A REPORT function consists of three main 
steps. First, you must indicate which forms from the 
file you want to include on the report. Next, you 
specify the printer that you want to use, the page size, 
and the title for the report. Finally, you choose the 
items from the pfs:FILE form that will appear as 
columns in the report and the order in which they will 
appear. In this final step, you can also choose to sort 
the report, total, average or count any column, print 
derived columns, or identify items by keywords. 


Selecting PRINT A REPORT 


To select the PRINT A REPORT function, have the 
REPORT Main Menu on the screen (start the REPORT 
program or press if necessary ). 


PFS:REPORT 


1 PRINT A REPORT 


2 PRE-DEFINE A REPORT 


3 SET NEW HEADINGS 


4 EXIT PFS:REPORT 


F10-continue 


If the REPORT program diskette is in drive A, remove 
it and replace it with the diskette containing the pfs: 
file. Do not remove your pfs: file from the diskette 
drive, or turn off the computer, unless the Main Menu 
is on the screen. 


If you look at the menu, you will see that the cursor is 
in the SELECTION NUMBER item. Type a 1 to select 
PRINT A REPORT, press the tab key to move the 
cursor to the FILE NAME item, and type the name of 
the pfs: file. Pressing to continue displays the 
blank form from the pfs: file on the screen. 


Step 1: Entering the Retrieve 
Specifications 


The first step when preparing a report is to indicate 
which forms from the file you want to include in the 
report. If you want to include all the forms from the 
file, leave the form blank and press . If you want 
to include only certain forms from the file, enter 
retrieve specifications exactly as you would for the 
Dfs:FILE SEARCH/UPDATE function. 


Retrieve specifications fall into five categories: 
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1. Fullitem match 


2. Partial item match 

3. Numeric item match 
4. Numeric range match 
5. “Not” match 


The next few pages summarize these specifications. 
When you have entered the desired retrieve 
specifications, press to continue with the next 
step in preparing your report. 


Note that the items you fill out in the retrieve 
specifications will not appear on the report unless you 
select them when entering the report specification 
(the third step in the process). 


1. Full Item Match 


In a full item match, the program will select all forms 
that have exactly the same characters in the specified 
item as those in the retrieve specification. REPORT 
uses the following rules to determine whether or not 
there is a match: 


e it ignores spaces before the first character and 
after the last character 
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e it treats multiple spaces within an item as a single 
space 


°e it does not differentiate between upper and lower 
case letters 


For example, if you enter the following retrieve 
specification, 


File: phonebk RETRIEVE SPEC Page 1 
F10-continue 


NAME: Tom Seal will be a match 
NAME: Thomas Seal will not be a match 
NAME: Tom Seal will be a match 
NAME: TOM SEAL will be a match 


2. Partial Item Match 


If an item contains several words or numbers, you can 
have REPORT search for only those words or numbers 
that you are interested in. You enter the exact 
information that you want to find, plus two dots (. . ) 
for information preceding or following it that you 
don't care about. For example, if you enter the 
following retrieve specification in the form fora 
stockbroker’s customer file, 


_..Tax Shelter. 
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File: broker RETRIEVE SPEC 


you will find a match for all customers with “Tax 
Shelter” as an objective (REPORT will ignore any 
‘ili objectives listed before or after ‘“Tax Shelter”. 


However, if you enter this specification, 


File: broker RETRIEVE SPEC Page 1 
F10-continue 
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then REPORT will only find those customers with 
“Tax Shelter”’ as the first listed objective. Similarly, if 
you enter . . Tax Shelter, REPORT will only find 
customers with “Tax Shelter”’ as the last listed 
objective. 


You can also search for items that are ‘“‘almost”’ an 
exact match by using the @ sign as a “wild card”’ 
character. For example, suppose you have a pfs: file 
that lists phone messages, and you are unsure of the 
spelling of a person’s name for whom you want to 
retrieve messages. If you enter this retrieve 
specification, 


: Bill Anders@n 


File: phonebk RETRIEVE SPEC Page 1 
F10-continue 


Bill Andersen will be a match 
Bill Anderson will be a match 
W.F. Andersen will not be a match 
Anderson, Bill will not be a match 


In the same way, if you have stored dates in a file as 
year, month, and day, in the form yy/mm/dd, you can 
find all forms with dates in October of 1981 by entering: 


81/10/@ @ 


as the retrieve specification. 


34. Numeric Item Match 


There are two ways to use numbers as information. 
One way is to use the number as a set of characters that 
identify something (phone number, social security 
number, or part number might be examples). These 
kinds of numbers usually have no arithmetic value. For 
example, you wouldn't want to calculate the total of a 
column of social security numbers. 


The other way is to use the number to represent an 
arithmetic value — something that has a meaning of 
larger or smaller (quantity, cost, or age might be 
examples). 


When the item on a pfs:FILE form is a number that 
represents an arithmetic value, you can look for all 
items less than, greater than, or equal to a given 
number. The retrieve specification consists of the 
special symbol(< > =) followed by the desired 
number. 


For example, suppose that you want to print a report 
from your Broker file that lists all customers with 
incomes over $50,000 who are interested in tax 
shelters. This is what the retrieve specification would 
look like: 
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Tax Shelter.. 


File: broker RETRIEVE SPEC Page 1 
F10-continue 


4. Numeric Range Match 


You can also search for numeric values in a certain 

range. To do this, give the lowest and highest values, 

separated by two dots and preceded by the equals sign. a 
The dot-dot (with the equals sign) means ‘through?’ 


For example, using the Broker file again, if you enter 
this specification: 
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File: broker RETRIEVE SPEC Page 1 
F10-continue 


the report will include all investors with income 
between $40,000 and $50,000. 


Note that in all numerical item matches, REPORT 
ignores any non-numeric characters such as dollar 
signs, slashes, etc. 


5. “Not”? Match 


You can include all forms that do NOT match a given 
specification by preceding the retrieve specification 
with a slash (/). For example, 


[JOHN finds all forms that do not have the word 
JOHN for this item 


/..er finds all forms that do not end with the letters 
‘er’ for this item 


/=33 finds all forms that do not have the number 33 
for this item 


Pg finds all forms with nothing entered for this 
item 
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If you have a multiple page form, press to 
display the next page so you can enter retrieve 
specifications there. will return to the previous 


page. 


When you have entered all the retrieve specifications 
necessary to identify the forms you want to include in 
the report, press . The Report Options Menu 
appears next: 


REPORT OPTIONS 


F10-continue 


UO 


Step 2: Choosing the Report Options 


The second step when preparing a report is to fill in 
the Report Options Menu. You use this menu to assign 
a title, select the printer, and specify the printed page 
size; or to print the report according to a previously 
defined report specification. Fill out the menu as 


follows: 


TITLE: 


PRE-DEFINED REPORT NAME: 


OUTPUT TO: 


Enter the desired report title (one 
line only) 
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If you want to use a report 
specification that you have 
previously saved with the 
PRE-DEFINE A REPORT function, 
enter its name here. (Chapter 2 
describes this function.) If not, 
leave blank. 


If you want to print the report to a 
printer, enter one of the 
following: 


LPT 1: for the IBM 80 CPS Matrix 
Printer or another parallel 
printer 


AUX: or COMI: for a serial 
printer 


If you want to print the report toa 
diskette file, enter the name of the 
file, including the drive name if 
the diskette containing the file is 
not in the default drive. The 
default drive is drive A unless you 
have changed it. 


If you want to print the report to 
the video display (console) 
enter CON: 
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LINES PER PAGE: Enter the number of lines on each 
page of your printer paper, 
perforation to perforation. 
(REPORT will automatically leave 
a top and bottom margin). 
Standard 8’ x 11 fanfold printer 
paper has 66 lines per page. 


PAGE WIDTH: Enter the width of your paper 

(between 40 and 255 characters). 
Standard 82 x 11 fanfold printer 
paper is 80 characters wide. Note 
that if you enter a width greater 
than 80 columns, you might have 
to send special characters to your 
printer to set it up. See Appendix 
D, “Sending Special Characters: 


When you have filled in the options that you want, 
press(F19)to continue. The blank form appears once 
again, this time for you to enter the report 
specification. 


Step 3: Entering the Report Specification 


1-14 


The last step before your report starts printing is to 
enter the report specification. This step determines 
which items will appear as columns in the report, and 
their order. You also define several special features of 
REPORT at this time; we will explain these features 
later in this chapter. 


Each report can have up to 16 columns. They are 
numbered from 1 to 16, starting with the left-hand 
column. To print an item as a column in the report, 
enter the desired column number next to the item 
name. 


REPORT sorts the report into alphabetical or 
numerical order based on the information in column 1. 
To sort the report according to a certain item, simply 
make that item column 1. If the information in column 
lis the same for more than one row, REPORT sorts 
those rows according to the information in column 2. 


REPORT needs temporary work space on a diskette in 
order to sort a report. It looks on the diskette in the 
work drive for this space. The work drive is drive B 
unless you change it (see ‘Setting up a Serial Printer 
and the Work Drive” in Appendix D). The diskette in 
the work drive should have free space at least equal to 
the size of the file you are sorting (see “Checking the 
Diskette Space”’ in Appendix C). 


If you do not need or do not want to sort your report, 
number your first column as column 3. If your report 
is long or complex, eliminating the sort in this way can 
save you some time. However, this does limit your 
report to 14 columns (numbered 3 through 16). 


For example, suppose you have a pfs: file that contains 
abstracts of recent publications. The form looks like this: 


File: catalog RETRIEVE SPEC Page 1 
F10-continue 
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You could prepare a report that shows publisher, 
author, and title for each of these publications, by 
entering this report specification: 


File: catalog REPORT SPEC Page 1 
F7-Derived Columns F10 - continue 


When you enter column numbers | and 2 in the report 
specification, REPORT will sort the report according 
to the information in those columns. 


id 


The publication report would look like this: 


A List of Books 


Arts Alive Press Adams, Joyce The Fundamentals of Modern Art 


O Eastern Publications Batteson, Barry Wreck Diving 
Johnson-Jones Inc. Weselly, John G. White Water Rafting 
Terlock-Green Inc. Grant, Frank Gardening at Home 

O west Coast Publishing Thayer, Henry R. The Political Spectrum 
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If a report contains items that take more than one line, 
REPORT inserts a blank line before and after the items. 
Also, when a non-numeric item in column | is the 
same for several forms, it only appears once on the 
report. These features make it easier for you to read 
the report. 


Now suppose you want the same report, but would 
like to start a new page whenever the publisher 
changes. You can do that by entering a P next to the 
column number (P will only work in column 1): 
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File: catalog REPORT SPEC 
F7-Derived Columns 


List of Books by Publisher 


Author 


Page i O 


O List of Hooks by Publisher 


Publisher 


Eastern Publications Batteson, Barry Wreck Diving 


Oo 


Numeric Columns 


If an item in your pfs: file contains numbers, you can 
choose to have REPORT treat that item numerically by 
entering the letter N next to the column number on the 
report specification. When printing numeric columns, 
REPORT observes the following rules: 


e it ignores all characters (including spaces) other 
than — ,.,0,1,2,3,4,5,6,7,8,9 (be sure to use the 


number 1, not lower case 1). 


e aminus sign (—) before the first digit or after the 
last gives the number a negative value 


e if there are multiple decimal points, it ignores all 


but the first 


e it lines up all the decimal points in the column 
and inserts commas as appropriate 


e it adjusts all entries in a column to the highest 
number of decimal places found in that column 


The following examples show how you might enter an 
item on the pfs:FILE form, and how REPORT would 
list it in a numeric column in a report: 


Value in 
Item Numeric Column 
$1,706.22 1706.22 
13 MAY 1980 131980 
70-06-29 700629 
20:45 2045 
FIVE (none) 


Explanation 
$ and , are ignored 
MAY is ignored 
— is ignored; the — 
must be before or 
after the number to 


be interpreted as a 
minus sign 


: is ignored 


letters are ignored 
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One frequent application of REPORT is to sort rows in 
a report by date. To make this possible, when you 
initially enter the data using pfs:FILE, enter year, 
month, and day values in the form yy/mm/dd. Always 
use two digits in each position. For example, 79/06/12 
stands for June 12, 1979. To get the report in order by 
date, you simply specify the date item as column 1, and 
as a numeric item (N). 


When you have finished entering the report 
specification, press to continue. REPORT will 
now begin preparing the report. First it will select the 
forms that meet the retrieve specifications you 
entered; while doing this, it displays a message that 
says “Selecting Forms?’ Next, if you specified columns 
lor 2 for the report, it sorts the forms, displaying the 
message “Sorting. Finally, it begins printing the 
report, displaying the first page of each form as it 
prints information from that form in the report. When 
it finishes printing, it returns automatically to the Main 
Menu. 


If you should want a printed copy of the report 
specification (or any other screenful of information), 
press the (E'S key while holding the Shift key 
down. will print whatever is on the screen at 
the time you press it. 


Printer Note 


some printers require that you send a series of special 
characters to set the printer up before printing starts. 
For example, sending a Ctrl O to the IBM 80 CPS 
Matrix Printer causes it to print in 132-character 
compressed mode. Also, if you have a serial printer 
connected with an Asynchronous Communications 
Adapter, you will need to give pfs: REPORT some 
special information such as baud rate. See Appendix D, 
“The pfs:REPORT Setup Programs,’ for an 
explanation of how to set up your printer in these 
situations. 
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Reports with Column Calculations 


You can total, count, or average the numbers ina 
column as well as give a subtotal, subcount, or 
subaverage every time the item in column 1 changes. 
For example, if you have three classes of students who 
all took the same test, you could get the average score 
for each class and the average score for all the students 
like this: 


Test Score Summary Report 


Student Test Score 


James, Kurt 
Lawrence, Arnold 


Average: 


Austin, Peter 
Church, Jill 


Aver age: 


Clayton, David 
Trapp, Iris 


0000000 00 0 0 


O 
O 
O 
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O 
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You specify the column calculations by entering the 
following commands beside the column number on 
the form: 


T Total. The program will automatically treat 


this item numerically, add all the numbers in 
the column, and print the total at the end. 
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ST 


SA 


SC 


Subtotal. This produces a subtotal for each 
new item in column 1, and a grand total at 
the end of the report. 


Average. The program will automatically 
treat this column numerically and print the 
average at the end. 


Subaverage. This produces a subaverage for 
each new item in column 1, and prints an 
average of all the numbers at the end. 


Count. This counts the number of entries in 
a column (whatever their value). 


Subcount. This gives a subcount for each 
new item in column 1, and a complete count 
at the end. 


The count and subcount commands count the number 
of items actually printed in a column. For example, 
take a look at this report: 


Corporate Phone Directory 


Phone Ext 


Bennet, Liza 
Thomson, John 
Woodhouse, Emma 
Woolf, James 


Calvin, Curt 
Fawley, Susan 
Peters, Marvin 
Sanchez, Enrico 


Only two items were counted in the DEPT column 
because each department name was printed only once. 
The PHONE EXT column has an entry for every line so 
the count for that column is eight. This report, 
therefore, tells you that you have two departments and 
eight phones. 


When you use T, ST, A, or SA, the program 
automatically assumes that the information in the 
column is numeric. However, because you can use C 
and SC with non-numeric information, you must enter 
N if you want REPORT to treat the column 
numerically. For example, the specification 
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PRICE: 5C 


might get a column that looks like this: 


Price 


$100 
4 dollars 
4.99 


Count: 4 


whereas the specification 
PRICE: 3CN 
would produce a column that looks like this: 


Price 


100.00 
4.00 


99 


Count: 4 


1-23 


When you plan to use these functions, you should 

think carefully about the difference between 0 (zero) 

and a blank in your pfs: file. In the test score example, 

for instance, the difference between a score of zero 

and no score is very significant. It is especially 

important when using average or count. When 

REPORT encounters an item that contains no J 
information, it does not include it in the calculation; 

but it will include an item that contains a zero. For 

example: the average of 4 and 2 is 


4+2 =3 
Z 


but the average of 4,2, and 0 is 


4+2+0=2 
4 


You can specify more than one of these functions in 

the same column, such as totalling and averaging the 

same column. For example, you may have a file 

containing information on sales, where the form looks wW/ 
like this: 


File: salestaf RETRIEVE SPEC Page 1 
F10-continue 
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By entering a report specification of 1 in the NAME 
item, and 2TA in the SALES item, you would get a 
report that looks like this: 


Sales Report 


Abrams, Art 12,001.09 
Beachamp, Fred 34,007. 
Button, L 36,120. 
Still, Stanley QO. 
Wilkes, Jim 20, 787. 


Average: 
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00 00 0 0 0 0 


This report shows the average sales per salesman and 
the total sales. If you use more than one of the column 
calculations, the average will appear first, then the 
total, then the count. You can enter the commands 
themselves in any order, i.e., 4AST, A4ST, and 4STA 
would all produce the same result. 


Note that subtotals, subaverages, and subcounts are 
not calculated when the information in column one is 
numeric (when N, T, ST, A, or SA is used as a report 
spec in column one). 


Example 


In this example, you will use the pfs: file named STAFF 
to produce a report on total salaries by department. 
The STAFF file is stored on your REPORT program 
diskette. In order to use it for these examples, first 
copy it to a blank, formatted diskette. “Copying a 
File’ in Appendix C describes how to copy a file. 
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If you haven't already done so, start the REPORT 
program by following the instructions in the 
Introduction (See page I-10). 


To begin, make sure the REPORT Main Menu is on the 
screen (press (Esc Jif necessary) and place the diskette 
with the STAFF file in drive A. Place a blank formatted 
diskette in drive B. Enter: 


1 
as the SELECTION NUMBER and enter: 


STAFF 
as the file name, then press to continue. 


The blank form from the STAFF file should appear on 
the screen, so that you can fill in the retrieve 
specifications. Since we want all the forms in the file 
included in the report, leave the form blank, and press 


to continue. 


The Report Options screen will appear next. Type in 
the title: 


Salary Costs by Department 


for the TITLE item, and leave the PRE-DEFINED 
REPORT NAME item blank, since we do not want to 
use a pre-defined report. Enter: 


Iptt: 


for the OUTPUT TO item (if it isn’t already there) to 
print to your IBM 80 CPS Matrix Printer or other 
parallel printer, and leave the standard settings of 66 
and 80 for LINES PER PAGE and PAGE WIDTH. The 
screen should look like this: 


REPORT OPTIONS 


F10-continue 


Press E'9 to go onto the next step. The blank form 
from the STAFF file will appear again, for you to enter 

ym, the report specifications. Press the tab key to 
move from item to item, entering the report 
specifications shown below: 


File: STAFF REPORT SPEC Page 1 
F7-Derived Columns F10-continue 
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When you have entred the report specifications, press 
(Fi@) and REPORT will sort the forms in the file, and 


begin printing the report. The printed report will look 
like this: 


Salary Costs by Department 
Monthly Salary 


Administration 1,200 
Thomson, John a, 000 
Woodhouse, Emma a_ 200 
Woolf, James 1,000 


Total: 19,400 


Manufacturing Calvin, Curt 3, 600 
Fawley, Susan 2,100 O 
Peters, Marvin 1,100 
Sanchez, Enrico Dy at 


O 
10,050 


O 
Oo 
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oO 
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Oo 
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You can see that REPORT prints the subtotal in the 
MONTHLY SALARY column every time it prints a new 
department in column 1. This gives the total salaries 
for each department. When you specify ST ina 
column, you also get a grand total at the end of the 
column. 


After the report is printed, REPORT returns to the 
Main Menu. 
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Reports with Derived Columns 


You can have up to three derived columns in your 
report. REPORT calculates derived columns from 
information in other columns (including other derived 
columns). Derived columns count towards the 16 
column maximum permitted for each report. 


You define a derived column by assigning a heading 
and entering a formula consisting of column numbers 
(identified by a # sign in front of the number), 
constants, and the following symbols: 


+ add 

— subtract 

* multiply 
divide 

() parentheses 


For example, #3 + 4 * #1 means to add 4 to column 3 
and multiply the result by column 1. You can use 
parentheses to indicate the order of the operations, 
e.g., #3 + (4 * #1) means to first multiply column | 
times 4, then add the result to column 3. If you do not 
enter parentheses, REPORT evaluates the formula 
working from left to right. 


To specify a derived column, press while 


entering the report specifications. A special screen 
appears: 
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DERIVED COLUMNS 


File: STAFF REPORT SPEC 
F7-Return to Form F10-continue 


Notice that the screen repeats the items three times, 
once for each possible derived column. Fill in the 
items as follows: 


HEADING enter the heading you want printed in 
the derived column. If you leave this 
blank, REPORT will print the formula 
of the column as a heading. 


FORMULA enter the formula for your derived 
column. Columns in the formula are 
identified with a # preceding the 
column number. 


REPORT SPEC enter a number to indicate which 
column you want this derived 
column to appear as. Also enter any 
column calculations you might want. 
You may even put the derived column 
in column 1, which means that the 
program will sort on the results of the 
derived column calculation. Note that 
this will take longer to sort than a less 
complex report. 


If you want to return to the main report specification 
screen, press again. When you have entered all 
the desired report specifications, press , and 
REPORT will prepare and print your report. 


Example 


Let’s use the pfs: file named STAFF again to calculate a 
17% bonus for each employee, and produce a report 
showing the monthly salary, bonus, and total pay for 
each employee. 


To begin, make sure the Main Menu is on the screen 
(start the REPORT program or press (esc) if 
necessary), then enter: 


1 


for the SELECTION NUMBER and type: 


Staff 


for the FILE NAME. Place the diskette that contains the 
STAFF file in drive A. Place a blank formatted diskette 
in drive B. Then press to bring up the blank 
form from the file, for you to enter the retrieve 
specifications: 
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File: Staff RETRIEVE SPEC Page 1 
F10-continue 


Since we plan to give a bonus to everyone, leave the 

retrieve specification blank and press again. 

The Report Options screen appears next. Fill in the | 
items as shown below: ) 


REPORT OPTIONS 


: Employee Bonus Report 


F10-continue WwW 
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Now press again, and the STAFF form will 
appear on the screen, this time so you an enter the 
report specifications. Type: 


1 
in the NAME item and type: 


2 


in the MONTHLY SALARY item. Then press to 
specify two derived columns: one for the amount of 
the bonus, the other for the total pay including the 
bonus. The following screen should appear: 
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DERIVED COLUMNS 


REPORT SPEC: 
HEADING: 
FORMULA: 
REPORT SPEC: 
HEADING: 
REPORT SPEC: 


File: Staff REPORT SPEC 
F7-Return to Form F10-continue / 


oe 


Enter the following information: 
HEADING: enter Bonus 


FORMULA: enter #2 * 0.17 (this calculates 17% 
of the monthly salary) 


REPORT SPEC: enter 3 (the new column will appear 
as column 3) 


Now enter the information for the second derived 
column: 


HEADING: enter Total Pay 


FORMULA: enter #2 + #3 (this adds the monthly 
salary and the bonus together) 


REPORT SPEC: enter 4T (the new column will 
appear as column 4, and will include 


a total at the bottom) 


The screen should now look like this: 


DERIVED COLUMNS 


File: Staff REPORT SPEC 
F7-Return to Form F10-continue 
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Now press (F10) to have REPORT prepare and print 
the report. The finished report will look like this: 


Employee Bonus Report O 
Monthly Salary 


Liza 1,404.00 O 
Curt A 212600 
Susan 2,457.00 
Marvin 1,287.00 ‘@) 

Sanchez, Enrico 

Thomson, John 

Woodhouse, Emma 

Woolf, James 
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When REPORT calculates derived columns, it works 
from left to right across the report. If columns 1 and 4 
were derived columns, column 1 would be calculated 
before column 4 in each row. This means that a 
formula must not use the values entered for that row in 
a derived column that appears to its right. Note also 
that REPORT rounds derived columns to two decimal 
places before printing. 
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A formula can include a reference to itself. For 
example, the formula used in column 7 might be #3+ 
#7. In this case, the value used will be that from 
column 7 of the previous row in the report. Thus, in 
this example, the formula will produce, in column 7, a 
running total of whatever was in column 3. (At the 
start of the report, all derived columns have a value of 
Zero.) 


Reports Using Keywords 


When you store information in the form of text in 
your pfs: files you may want to identify the 
information by means of subject keywords. You might 
identify a form by several different keywords because 
it is of interest for several different reasons. 


To print a report using keywords, enter K as part of the 
report specification for the column that contains the 
keywords. (The K specification will only work for 
column 1.) REPORT will print the report, sorted 
alphabetically by keyword, with each form appearing 
once for every keyword listed. 


Note that preparing a keyword report can be a fairly 
time-consuming task, depending on the complexity of 
your form and the number of keywords entered for 
each form. 


Suppose you keep a pfs: file with technical 
information from the magazines you read. The form 
might look like this: 


File: abstract RETRIEVE SPEC Page 1 
F10-continue 


The KEYWORDS item includes all the subjects for 
which the article is of interest. The ABSTRACT item 
gives a brief description of the article. By using the 
following report specification: 


File: abstract REPORT SPEC Page 1 


F7-Derived Columns F10-continue 


you could get this report: 
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Keyword Sort of Abstracts 
O 


Keywords Magazine Abstract 


Data News This article describes the use of a new ECL 
process to fabricate 14K RAMs for less than $4 each. 


Elec Tiges An unsuspected cause of RAM failure has O 
been traced. People have found that ga@a@a radiation 
saan de O 
causes randoa teaporary bit faults. 


Weekly News A problea is discussed which causes premature 
failure of memories due to warpage of the PC boards, © 
especially at high teaperatures. 
O 
Data News This article describes the use of a new ECL 
process to fabricate 14K RAMs for less than $4 each. O 


Weekly News A problem is discussed which causes preaature O 
failure of semories due to warpage of the PC boards, 
especially at high temperatures. 


PCboards Weekly News A problea is discussed which causes preaature oO 
failure of aegories due to warpage of the PC boards, © 
especially at high teaperatures. 


Data News This article describes the use of a new ECL 
process to fabricate 14K RAMs for less than $4 each. O 


Elec Tig@es An unsuspected cause of RAM failure has O 
been traced. People have found that gamaa radiation 
causes random teaporary bit faults. 


Oo 
O 
Oo 
Oo 
Oo 
O 
Oo 
Oo 
Oo 
Oo 
oO 
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As you can see, REPORT prints the abstract that appeared 
on the first screen in this section three times, once for 
each keyword. If you did not use the K specification, you 
would get this report from the same information: 
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A Norgal Report 
Keywords Magazine Abstract 


Occ Memory RAMs Data News This article describes the use of a new 
ECL 

O process to fabricate 14K RAMs for less t 

Oo han $4 each. 


© failure Meaory PCboards Weekly News A probles is discussed which causes prea 
ature 

re) failure of @emories due to warpage of th 
e PC boards, 

@) especially at high temperatures. 


OFfailure RAMs Elec Times An unsuspected cause of RAM failure has 
been traced. People have found that gas 

Oo ma radiation 

O causes randoa teaporary bit faults. 
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When you enter keywords into an item on your form, 
separate them from each other with a space (Smith 
Jones Brown). If you have a key ““word’”’ that is more 
than one word long, do not space between the words 
(e.g., PersonalComputers). 


Summary 


e Use the PRINT A REPORT function to specify a 
report that lists any of the items in a pfs: file for 
as many forms as you choose. 


e There are three steps in specifying the report: 


Ie the retrieve specifications identify the 
forms you want to include in the report 


Bis the Report Options describe the title and 
page size for the report, and whether 
there is a predefined report specification 


ai the report specifications identify the 
items you want to include in the report, 
and the order in which you want them to 


appear. 1-39 
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You can use any of the following commands as 
report specifications, to control the columns of 
the report: 


N 


A 


SA 


SC 


ST 


Numeric. Treats the column numerically, 
and lines up the decimal points. 


Average. Treats the column numerically and 
prints an average at the end. 


Subaverage. Gives a subaverage whenever 
column 1 changes. 


Count. Counts the number of entries in a 
column, whether the information in the 
column is numeric or alphabetical. 


Subcount. Gives a subcount whenever 
column 1 changes, whether the 
information in the column is numeric or 
alphabetical. 


Total. Treats the column numerically and 
prints a total at the end. 


Subtotal. Gives a subtotal whenever 
column 1 changes. 


Page break. Starts a new page each time 
the entry in column | changes (can only 
be used in column 1). 


Keyword. Prints the same form once for 
every string of characters (keyword) in the 
item selected (can only be used in column 
1). Separate keywords by blanks. 


Identifies a number in a derived column 
formula as a column number. 


Switches between the main report 
specification screen and the derived 
column specification screen. 


Displays the next page of a multiple page 
form. 


Displays the previous page of a multiple 
page form. 
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Chapter 2. Pre-Define A Report 
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Chapter 2. Pre-Define A Report 


This chapter explains how to use PRE-DEFINE A 
REPORT to save a report design for repeated use. The 
chapter includes two examples: one shows you how to 
define a report specification; the other shows how to 
modify an existing pre-defined report specification. 


You can save up to eight different report designs for 
each pfs: file. In this way, you can print a monthly or 
periodic report in the same format every time, without 
repeating the report specification process. You give 
each design a name up to 10 characters long, and 
REPORT stores the design in the pfs: file. When you 
want to use one of these reports, you enter the name 
in the PRE-DEFINED REPORT NAME item of the 
Report Options Menu. REPORT will then produce the 
report without going through the report specification 
step. 
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This function is also useful if you want to try out a 
report specification before you decide to use it. Since 
REPORT saves the specification on the diskette, you can 
try out several different designs, using different names, 
until you find one that you like. Then simply remove 
the other designs. 


Selecting the PRE-DEFINE A REPORT 
Function 


To begin the PRE-DEFINE A REPORT function, first 
return to the Main Menu (start REPORT or press 
if necessary). Then enter 2 for the SELECTION 
NUMBER item, and the name of the pfs: file in the 
FILE NAME item. Pressing to continue will 
display the names of any pre-defined reports already 
stored for that file: 
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PRE-DEFINED REPORTS: 


SAMPLE 


Defining a Report Specification 


To define a new report design, enter the name you 
want to give to the new design, then press [F1#®} . The 
blank form from the file will appear for you to enter 
the report specification. Enter the report specification 
exactly as you would if you were using the PRINT A 
REPORT function, then press REPORT will 
store the report design in the pfs: file and return to the 
Main Menu. 


Modifying an Existing Report 
Specification 


To modify an existing design, enter its name in the 
REPORT NAME item and press (F1#} . The report 
specification will appear on the screen for you to 
modify. You can type over an existing specification, or 
press(Ctrl }(Hom) to erase all the information on the 
displayed page and start over. When you have entered 
all the modifications you want to make, press 
and REPORT will store the new design in the 


Dfs: file. 


Removing a Report Specification 


To remove a design, enter its name in the REPORT 
NAME item and press . When the report 
specification appears on the screen, press 
REPORT will display a warning, giving you the chance 
to change your mind: 


REPORT ‘SAMPLE’ 


ABOUT TO BE REMOVED 


Press F10 if ok 
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Press SPACE to keep 


If you really do want to remove the design, press 
and REPORT will erase it from the file. 
Otherwise, press the space bar to keep the design. 


Example 1: Defining a Report 
Specification 


By following this example, you will define a report 
design for the STAFF file that will show total salaries 
by department. You can use this report to track 
changes in the monthly salary expense. (The STAFF 
file can be found on the REPORT program diskette; see 
the Preface for instructions on how to use it, if you did 
not follow the example in Chapter 1.) 
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To begin, return to the Main Menu (start the REPORT 
program or press (esc) if necessary), and insert the 
diskette that contains the STAFF file in drive A. Place a 
blank formatted diskette in drive B. Then enter: 


2 
for the SELECTION NUMBER item, and type: 
Staff 


for the FILE NAME item. The screen should look like 
this: 


PFS:REPORT 


1 PRINT A REPORT 


2 PRE-DEFINE A REPORT 
3 SET NEW HEADINGS 


4 EXIT PFS:REPORT 


F10-continue 


Press to continue. REPORT displays the 
following screen: 


PRE-DEFINED REPORTS: 


(None) 


F10-continue hs 

¢ 

2. 

fa") 

coat 

= 

@ 

p=) 

Type the word: a 
S 

Salaries g 


for the REPORT NAME, and press [F1®} again. The 
blank form from the STAFF file will appear, with the 
new report name (Salaries) at the bottom of the screen. 


Assume that you want the report to show department, 


name, and salary, with the salaries subtotalled by 
department. Enter the following report specification: 
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File: Staff REPORT ‘SALARIES’ Page 1 
F3-Remove F7-Derived Columns _—«F10-continue 


Since this completes the report specification, press 
F18) to save the design in the STAFF file and return 
to the Main Menu. 


Now, let’s print the report. Enter: 
1 


for the SELECTION NUMBER, and press to 
continue. The STAFF form will appear for you to fill 
out the retrieve specification. Since you want to 
include all forms from the file in your report, press 
without entering any retrieve specifications. 


The Report Options Menu appears next, for you to 
assign the title, the output device, and the page size. 
Fill in the information shown below: 


REPORT OPTIONS 


Monthly Salaries, March 


F10-continue 


Press (F106) and REPORT will prepare and print the 
report according to the Salaries report specification. 
The report will look like this: 
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Monthly Salaries, March 
Monthly Salary 
Administration Bennet, Liza 
Thomson, John 
Woodhouse, Emma 


Woolf, James 


Total: 10, 400 


Manufacturing Calvin, Curt 3, 600 
Fawley, Susan 25 800 
Peters, Marvin 1,300 
Sanchez, Enrico See 


10,050 


00000 00 0 0 


0000000 0 0 0 0 
O 


O 
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Example 2: Modifying an Existing Report 
Specification : 


In this example, you will modify the report 
specification defined in the previous example so that 
the resulting report includes the JOB TITLE item from 
the file. The Main Menu should be on the screen, so 
enter: 


2 


as the SELECTION NUMBER and leave Staff as the FILE 
NAME. Press [F18} to continue. REPORT displays the 
following screen: 


PRE-DEFINED REPORTS: 


SALARIES 


F10-continue 


Enter the word: 
Salaries 


for the REPORT NAME, and press and the 
report specification will appear: 


3ST 


File: Staff REPORT ‘SALARIES’ Page 1 
F3-Remove F7-Derived Columns F10-continue 


Assume that you want to make Job Title the third 
column. Press the tab key to move to that item 
and type: 
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3 


Then change the entry in the MONTHLY SALARY item 
from 3ST to: 


4ST 


and press to store the new specification in the 


Dfs: file. 


Now, let’s print the new report to the display instead 
of the printer. Return to the Main Menu and select the 
PRINT A REPORT function (leave STAFF in the FILE 
NAME item). Press and the form from the STAFF 
will appear, ready for you to enter the retrieve 
specifications. Again, you want to include all forms in 
the file, so press (F168) to go on to the Report Options 
Menu. Enter the following information in the menu: 
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REPORT OPTIONS 


Monthly Salaries, March 


F10-continue 


Notice that we leave the lines per page set at the default 
response of 66; any number would do, since REPORT 
assumes a page length of 24 lines whenever you direct 
a report to the display screen (CON:). When you have 
entered the report options, press and REPORT 
will prepare your report and display it on the screen: 


Monthly Salaries, March 


Dept. Name Job Title Monthly Salary 


Administration Bennet, Liza Secretary 1,200 
Thomson, John Company President 5,000 
Woodhouse, Emma Purchasing Manager 3,200 


Woolf, James Personnel Clerk 1,000 
10.400 


Total: 


Calvin, Curt Process Engineer 3,600 
Fawley, Susan Engineering Associate 2,100 
Peters, Marvin Technician 1,100 
Sanchez, Enrico Design Engineer 3,250 


10,050 


Manufacturing 


Press F10 for more.. 


REPORT displays the first 24 lines, with the message 
Press F10 for more at the bottom of the screen. At 
that point, pressing would display the next 


page. 
>, 
| Summary 
e Use the PRE-DEFINE A REPORT function to save 
the design of a report that you want to use nxore 
than once. 
e You can store up to eight different report 
specifications for any pfs: file. REPORT stores 
them on the data diskette under a name that you 
assign (names can be up to 10 characters long, but fie 
the name for each report stored for a particular ig 
file must be unique. ) = 
fa) 
e You can modify or remove any pre-defined ~ 
report specification. £ 
a S 
° removes a pre-defined report -_ 
specification 
° clears all report specifications from 
the page of the form on the screen 
oOo” 
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Chapter 3. Set New Headings 
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Chapter 3. Set New Headings 


This chapter explains how to use the SET NEW 
HEADINGS function to change the headings that are 
printed at the top of each column. When you print a 
report without using this function, REPORT will use 
the first line of each item name as a column heading. 
Since REPORT determines column widths for the 
report by the number of characters in the heading or 
by the widest entry in the column, you may want to 
change the heading to make the column narrower. 


The example in this chapter describes how to change 
the heading in the STAFF file. 


Selecting SET NEW HEADINGS 


To begin the SET NEW HEADINGS function, return to 
the Main Menu (Start REPORT or press (Es) if 
necessary), enter 3 in the SELECTION NUMBER item, 
and enter the name of your file in the FILE NAME item. 
Press {F186} and the blank form from the file will 
appear on the screen. Enter the new heading for an 
item as you would enter information for that item: 
press the Tab key to reach the item, then type in 
the desired heading. When you have entered all the 
new headings, press and REPORT will store the 
new headings in the pfs: file. 
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REPORT will use these column headings in all future 
reports from that pfs: file unless you change them 
again. The next time you use the SET NEW HEADINGS 
function for the same file, your new column headings 
will appear on the form as if you had just entered 
them. 


To modify the new headings, you can type over them 
(type spaces), or press to erase any headings 
entered for that page of the form and start over. Then 
press and REPORT will store the modified 


headings in the file. 
3-3 


To remove all the headings and revert to the item 
names from the form, press when the headings 
are on the screen. REPORT will warn you that it is 
about to remove the headings, and give you a chance 
to change your mind. Press to proceed with the 
removal. 


Example 
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In this example, you will make some changes to the 
headings in the STAFF file. First, make sure that the 
Main Menu is on the screen (start the REPORT program 
or press (ec) if necessary), and that the STAFF file is 
in drive A. Then enter : 


3 
for the SELECTION NUMBER and type: 
Staff 


for the FILE NAME. The screen should look like this: 


PFS:REPORT 


1 PRINT A REPORT 


2 PRE-DEFINE A REPORT 


3. SET NEW HEADINGS 


4 EXIT PFS:REPORT 


F10-continue 


Press to continue, and the form from the file 
will appear, with the word ‘““HEADINGS” at the 
bottom of the screen: 


er 


File: Staff HEADINGS Page 1 
F10-continue 


To start with, you are going to change MONTHLY 
SALARY to just SALARY, since the entries in that item 
are typically only a few characters, and DEPT to 
DEPARTMENT, since the names of the departments are 
typically quite long. Use the Tab key to move 
to the MONTHLY SALARY item, and enter the word 
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Salary 
Then tab to the DEPT item, and enter the word: 
Department 


The screen should now look like this: 


a9 


File: Staff HEADINGS 


Press to store the new headings in the pfs: file. 
From now on, when you print a report from the 
STAFF file, it will use these headings. If you print the 
pre-defined report named Salaries, it will look like 
this: 


Salaries Report, New Headings 
Department Job Title 

Bennet, i Secretary 

Thomson, Company President 


Woodhouse, Emma Purchasing Manager 
Woolf, James Personnel Clerk 


Manufacturing Calvin, Curt Process Engineer 


Fawley, Susan Engineering Associate 
Peters, Marvin Technician 
Sanchez, Enrico Design Engineer 
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Summary 


Use the SET NEW HEADINGS function when you 
want column headings different from the item 
names in your pfs: file. 


You enter the new column headings on the blank 
form; REPORT uses them on all future reports. 
You can change or remove these headings in the 
same way as you change any information ina 
Dfs:FILE form. 


erases all headings from the page of 
the form on the screen, and returns 


the cursor to the first item on the 


form. 
removes all headings from the entire 
form. 
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Notes 


Chapter 4. Exit pfs: REPORT 
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Notes 


Chapter 4. Exit pfs: REPORT 


When you have finished using the REPORT program 
and want to use DOS or run another program, the 
EXIT pfs:REPORT function will return you to DOS. 


Selecting EXIT pfs:REPORT 


To use the EXIT function, enter 4 in the SELECTION 
NUMBER item. Place the REPORT diskette in drive A. 
Then press (a FILE NAME is not necessary). The 
Main Menu will disappear from the screen, and the 
DOS prompt (A >) will appear at the top of the screen. 


At this point, you can load any program stored ona 
diskette in one of the drives. For example, if you place 
the pfs:FILE diskette in drive A, you could load 


Dfs:FILE by typing: 
FILE 


after the A> prompt and pressing the Enter 
key. Or you could list the files on a diskette, delete a 
file (see Appendix D), or turn off the computer. 


Summary 


e Use the EXIT pfs:REPORT function to exit from 
REPORT and return to DOS. 
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Appendix A. Messages 


pfs:REPORT displays a message whenever it 
encounters an error condition. Certain errors are the 

y N result of mistakes you make when you enter 
information (filling in the Main Menu, the Report 
Options, or the report specification). Other errors are 
the result of physical limitations or problems with 
certain elements of your computer system. 


Most of these messages appear in the message area at 
the bottom of the screen: 


PFS:REPORT 


1 PRINT A REPORT 


2 PRE-DEFINE A REPORT 
SET NEW HEADINGS 


EXIT PFS:REPORT 


CAN'T FIND FILE F10-continue 


pfs:REPORT displays other messages on a separate 
screen: 
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PROBLEM 


CAN'T FIND REPORT ‘SAMPLE’ 


Press ESC to return to Main Menu 


(See manual Appendix A) 


When you encounter one of these messages, simply 
locate the message in the list below and follow the 
instructions in the Corrective Action column. To 
restart normal REPORT operation, press the 


(Ec) key. 


Following is the list of REPORT messages, arranged in 
alphabetical order: 


Message Description Corrective Action 


AUX I/O ERROR = Your serial printer is not Check to make sure all 
set up properly. the cables are all 

securely connected. Use 
the SETUP program to 
set the baud rate and 
other parameters. See 
Appendix D, “Setting 
Up a Serial Printer and 
the Work Drive” 


Message 


Description 


BAD FILE NAME You entered an illegal 


CAN’T CREATE 
WORKFILE 


CAN’T FIND 
FILE 


file name or drive name. 


REPORT needs 
temporary work space 
to complete this 
operation. REPORT 
looks on the diskette in 
the work drive for this 
space. 


REPORT could not find a 
file with the file name 
you specified. 


Corrective Action 


Make sure the file name 
is a set of characters that 
begins with a letter and 
does not contain spaces 
(see the IBM DOS 
manual for a description 
of valid filenames. If you 
have included a drive 
name, make sure it isa 
valid name. 


The work drive is drive 
B unless you have 
changed it. Make sure 
there is a blank, 
formatted diskette in the 
work drive. 


See Appendix D, 
“Setting Up a Serial 
Printer and the Work 
Drive. 


If you have a larger 
capacity drive, make 
sure it is turned on and 
that there is free space at 
least equal to the size of 
the file. 


Make sure you have 
spelled the name 
correctly, and included 
the correct prefix (A:,B:, 
etc.) if the diskette 
containing the file is not 
in the default drive 
(drive A unless you have 
changed it). See the 
section, “Specifying the 
Default Drive, in your 
DOS manual. 
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Message 


CAN’T FIND 
REPORT ‘xyz’ 


DIRECTORY 
FULL 


DISKETTE FULL 


DISKETTE HAS 
BEEN MOVED 


DIVIDE BY 
ZERO 


DRIVE NOT 
READY 


Description 


You requested a report 
using the pre-defined 
report name ‘xyz.’ 
REPORT cannot find a 
report with that name in 
the pfs: file. 


You attempted to store a 
report ina file ona 
diskette that already has 
64 files ona 160KB 
diskette or 112 files ona 
320KB diskette. 


REPORT attempted to 
write some information 
(such as new headings or 
a pre-defined report) on 
a diskette, and found 
there was no room left. 


You have removed the 
data diskette from the 
diskette drive during an 
operation. 


Your Pfs: file has been 
damaged. 


The diskette drive door 
is open. 


Corrective Action 


Make sure the report 
you request is one of 
those listed on the Pre- 
Defined Reports screen. 
(See “Selecting the PRE- 
DEFINE A REPORT 
Function” in Chapter 2). 


If you have some 
unneeded files on the 
diskette, remove them 
(see Appendix C, 
‘Erasing Files’). 


If you have some 
unnecessary forms in 
the file, use the pfs:FILE 
REMOVE function to 
remove them. 


If the diskette has 
unneeded files on it, 
remove them (see 
Appendix C, “Erasing 
Files’). 


You could also use the 
Dfs:FILE COPY 
function to move the file 
to a diskette that has 
more room. 


The file may have 
structural damage. To 
test it, start pfs: FILE 
and try to search 
through the file. If you 
can search, the file is 
probably OK. 


Discard the diskette, 
make a copy of your 
backup data diskette, 
then start using the 
backup. 


Close the door. 


Message 


DISKETTE IS 
WRITE 
PROTECTED 


ERROR 
ENCOUNTERED 
WHILE TRYING 
TO BACK UP 


ERROR IN 
FORMULA 


Description 


REPORT cannot use 
Dpfs:FILE diskettes that 
are write protected, 
because it uses certain 
areas of the diskette to 
store temporary 
information (such as 
retrieve or report 
specifications). 


The blank diskette you 
are attempting to use to 
back up your program 
diskette is defective. 


You have already 
completed the backup 
procedure. REPORT will 
only allow you to make 
one backup copy. 


The formula for a 
derived column is 
incorrect due to: 


(a) an unrecognizable or 
out-of-sequence 
character. 


(b) parentheses nested 
more than two deep. 


Allowed: 1 + (2 —(3)) 
Not Allowed: 
1+(2+(3+(4))) 


Corrective Action 


Remove the write- 
protect tab. To protect 
your information, you 
can use the COPY 
function to make a 
backup copy of the pfs: 
file. 


Use another diskette. 
Make sure to use high 
quality, double density 
diskettes. 


Insert the DOS diskette 
in drive A and turn the 
computer off, then on. 
When you see the DOS 
prompt (A>), return to 
step 1 of the backup 
instructions, “Making a 
Backup Copy of the 
REPORT Program 
Diskette,’ and try again. 


None. 


Turn the computer off. 
Then start REPORT by 
following the instructions 
in the Introduction, 
“Starting REPORT When 
the Computer is Off.’ 


The cursor is over the 
character causing the 
trouble. Over-type the 
formula to correct it and 
try again. 
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Message 


FILE IS 
MAXIMUM SIZE 


INVALID 
SELECTION 
NUMBER 


1/O ERROR 


Description 


You have attempted to 
print a report for a file 
that has reached the 
maximum size (4 million 
bytes). 


The number you entered 
for the SELECTION 
NUMBER of the Main 
Menu is invalid. 


There is a physical 
problem with either the 
diskette drive, the drive 
controller, or the 
diskette itself. Some 
possible causes are: 


The diskette in the drive 
is not formatted 


Diskette inserted 
incorrectly 


Worn out diskette 


Malfunction 


Corrective Action 


If there are unneeded 
forms in the file, use the 
Dfs:FILE REMOVE 
function to make room 
for the report 
specification. 


Re-enter a number 
between 1 and 4. 


Format the diskette. See 
‘Formatting Diskettes”’ 
in Appendix C. 


Remove the diskette, 
then re-insert it properly 


After 40-50 hours of use, 
the diskette may need 
replacing. Try using a 
different diskette. 


DO NOT USE THIS 
DISKETTE AGAIN. 
First, make a copy of 
your backup diskette 
(not the diskette causing 
the problem), then use 
that copy to re-enter any 
necessary information. 
If I/O ERROR persists, 
take the diskette drive to 
your dealer for testing. 


Lg 


Message 


MUST GIVE A 
FILE NAME 


MUST SPECIFY 
OUTPUT 
DESTINATION 


PRINTER NOT 
READY 


Description 


You have left the FILE 
NAME item of the Main 
Menu blank. 


You have left the 
OUTPUT TO: item of 
the Report Options 
Menu blank. REPORT 
doesn’t know where to 
print the report. 


REPORT cannot access 
the printer you named in 
the OUTPUT TO: item. 


REPORT IS TOO The diskette in the work 
LONG TO SORT — drive you indicated does 


not have enough space. 


Corrective Action 


Enter the name of the 
file you want to use. 


Enter the name of the 
destination device for 
the report. The choices 
are: LPT 1:, COMI1:, 
AUX:, CON:, or the 
name of a diskette file. 


Make sure the printer is 
properly connected and 
turned on, on-line and 
has plenty of paper. 
Check to see that the 
name you used is a valid 
name. See “Using pfs: 
Files” in Introduction. 
If this problem occurred 
while printing a report, 
return to the Main Menu 
and start the PRINT A 
REPORT function again. 


Specify a shorter report 
by including fewer 
forms in the report, or 
start the report again, 
this time inserting a 
diskette in the work 
drive that has more free 
space than before. (See 
Appendix D, “Setting 
Up a Serial Printer and 
the Work Drive’’). 
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Message 


REPORT TOO 
WIDE 


SEARCH LIST 
TOO LONG 


YOU CAN PRE- 
DEFINE 8 
REPORTS 
MAXIMUM 


** (in the report 
itself) 


Description 


The report you specified 
will not fit in the page 
width. A frequent cause 
of this is that the item 
names are very long, 
which forces the 
columns to be 
correspondingly wide. 


The retrieve 
specifications will not fit 
in the internal storage 
space. 


You attempted to create 
a pre-defined report 
when eight were already 
stored in the file. 


REPORT was unable to 
calculate the numeric 
value of this item 
because: 


(a) Overflow. The value 
to be printed exceeded 
20 digits either in this 
original form in the file, 
or during processing. 


Corrective Action 


To change the PAGE 
WIDTH, press (Esc } ; 
then restart the report, 
this time specifying a 
wider page. 


To print out as much of 
the report as will fit, 
press the space bar. 


To shorten column 
headings, use the SET 
NEW HEADINGS 
function (see Chapter 3.) 


Specify fewer requests in 
the retrieve 
specifications. 


Delete an unwanted 
report design by 


pressing 


Use smaller numbers 
(less than 20 digits). 


Message 


* * 


Description 


This can be due to an 
error in a derived 
column specification, or 
to a form in the file 
having an exceptionally 
large number of trailing 
decimal places which 
causes all values to be 
given that number of 
places and thus possibly 
to exceed 20 digits. 


(b) A derived column 
formula referred toa 
value in a derived 
column to the right in 
the same row. Since the 
columns are evaluated 
from left to right for 
each row, the value is 
not yet known. 


(c) An attempt was made 
to divide by zero ina 
formula. 


Corrective Action 
Correct the formula. 


Reduce the number of 
decimal places. 


Re-arrange the derived 
columns so that they can 
be calculated from left to 
right. 


Correct the formula. 
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Appendix B. Example File 


This manual uses a series of examples based on a pfs: 
file named STAFF. When you receive your 


i 
pDfs:REPORT package, you will find the file stored on 
the program diskette. Before using STAFF, you need to 
copy it to a blank, formatted diskette. If for some 
reason you do not have access to that file, you can 
create one like it by following the instructions below. 
To create the STAFF file, load pfs:FILE and, when the 
Main Menu appears, select the DESIGN FILE function 
and assign STAFF as the file name. Then type in the 
following design: 
Employee #: Hired: 
ym, 
Name: 
Address: 
City: State: Zip: 
Dept: Phone Ext: 
Job Title: 
Monthly Salary: 
o—~ 
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When you have completed the form design, press 

to continue. You should see the Main Menu on 
the screen. Select the ADD function, and enter 
information for the eight employees listed below. 
Enter the information exactly as it is shown, even 
though some of the items are inconsistent. This file 
can then show you how pfs:REPORT deals with these 
inconsistencies. 

Employee #: M8877 Hired: 74/11/05 

Name: Calvin, Curt 

Address: 254 Greentree Lane 


City: Woodville State: Ca Zip: 93137 


Dept: Manufacturing Phone Ext: 188 
Job Title: Process Engineer 


Monthly Salary: $3600 


Employee #: M3245 Hired: 78/06/22 
Name: Sanchez, Enrico 

Address: 7831 Parkside Place 

City: Ridgewood State: Ga Zip: 93132 


Dept: Manufacturing Phone Ext: 189 
Job Title: Design Engineer 
Monthly Salary: $3,250 


wy 


Employee #: A3476 Hired: 80/10/21 
Name: Thomson, John 

Address: 869 Valley View Road 

City: Ridgewood State: Ca Zip: 95152 


Dept: Administration Phone Ext: 155 
Job Title: Company President 


Monthly Salary: $5,000 


Employee #: A0765 Hired:76/09/21 
Name: Bennet, Liza 

Address: 754 Granville Place 

City: Ridgewood State: Ga Zip: 93132 


Dept: Administration Phone Ext: 119 
Job Title: Secretary 
Monthly Salary: 1,200 


Employee #: M0934 Hired: 77/09/30 
Name: Fawley, Susan 

Address: 5634 Ridgewood Way 

City: Woodville State: Ga Zip: 93137 


Dept: Manufacturing Phone Ext: 195 
Job Title: Engineering Associate 


Monthly Salary: 2100 
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Employee #: M5524 Hired: 81/04/27 
Name: Peters, Marvin 

Address: 3224 Valley View Road 

City: Ridgewood State: Ca Zip: 93132 


Dept: Manufacturing Phone Ext: 167 
Job Title: Technician 


Monthly Salary: $1100 


Employee #: A1265 Hired: 76/04/23 
Name: Woodhouse, Emma 

Address: 425 Oakview Way 

City: Ridgewood State: Ga Lip; 93132 


Dept: Administration Phone Ext: 179 
Job Title: Purchasing Manager 
Monthly Salary: $3,200 


Employee #: A0139 Hired: 72/09/16 
Name: Woolf, James 

Address: 9732 Sunrise Place 

City: Ridgewood State: Ca “Zip: 93132 


Dept: Administration Phone Ext: 143 
Job Title: Personnel Clerk 


Monthly Salary: $1,000 


Appendix C. Useful DOS 
Commands 


There are six DOS commands that you might want to 
y ON use when working with the REPORT program. These 
) commands are: 


FORMAT for preparing diskettes for use 
DIR for listing files on a diskette 
RENAME for changing the name of a file 
ERASE _ for removing a file from a diskette 


CHKDSK for finding out how much diskette space is 
available 


COPY _ for copying a file from one diskette to 
another 


This appendix describes how to issue each of these 
commands. 


Formatting Diskettes 


You must format new diskettes before they can be used 
in the IBM Personal Computer. This makes magnetic 
tracks on the diskette that will store the data later. We 
recommend formatting a supply of diskettes at one 
time and marking them on the label so you know they 
have been formatted. 


To format a diskette while using REPORT, follow these 
steps: 


i 1. Exit from REPORT and insert the DOS diskette in 
drive A. 
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2. Next to the DOS prompt (A >) on the screen, 
ty pc: 


FORMAT B: 
and press the Enter key. 
3. When DOS displays the message: 


Insert new diskette for drive B 
and strike any key when ready 


insert the diskette you want to format in drive B 
(or drive A if you have a one-drive system) and 
press a key. The screen will display a message 
while it is formatting (Formatting..) and then this 
message when formatting is complete: 


Formatting..Format complete 
Format another (Y/N)? 


4. Remove the diskette from drive B. You can go on 
to format other diskettes, or type N to return to 
the DOS prompt (A >). 


Listing Files 

There are times when you want to see a list of the files 
stored on a particular diskette. The DIR command 
gives you such a list, including the file name (extension 


too, if applicable), the size of the file (in bytes), and the 
date the file was last updated. 


To list your files while using REPORT, follow these 
steps: 


1. Insert the REPORT diskette in drive A and exit 
from the REPORT program. The DOS prompt 
(A >)will appear on the screen. 


2. Replace the REPORT diskette with the diskette 
whose files you want to list. 


4. Type the command DIR, then press the Enter 
key. The list might look like this: 


FILE1 200 5-16-82 11:33a 
FILE2 6250 8-06-82 2:10p 
FILE3 3080 12-28-82 3:45p 


The DOS prompt (A >) will appear below the last 
entry in the list. At this point, you may enter another 
command, reload REPORT, or run another program. 


Renaming Files 


From time to time, you may want to change the name 
of one of your files. To rename a file, follow these 
steps: 


1. Insert the REPORT diskette in drive A, and exit 
from the REPORT program. 


2. Replace that diskette with the diskette containing 
the file you want to rename in drive A. 


3. Next to the DOS prompt (A >), enter the 
command RENAME, the current file name, a 
space, and the new file name. For example, type: 


RENAME A:Fred John 


‘a and press the Enter key to change the 
name of the file Fred, stored on the diskette in 
drive A, from Fred to John. The DOS prompt 
(A >) will re-appear when the renaming 
operation is complete. At this point, you can 
enter another command, reload REPORT, or run 
another program. 
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You can also add an extension to a name, or 
change an existing extension, with the RENAME 
command. To do so, enter RENAME, the current 
file name, a space, the file name, then a dot and 
the new extension. For example, type: 


RENAME B:Fred Fred.123 


and press the Enter key to add the 
extension .123 to the file named Fred that is 
stored on drive B. 


Erasing Files 


Even if you remove all the forms from a pfs: file, the 
file remains on the diskette. To erase a file while using 
REPORT, follow these steps: 


1. Insert the REPORT diskette in drive A, and exit 
from the REPORT program. 


2. When the DOS prompt (A >) appears, replace the 
REPORT diskette with the diskette containing the 
file you want to erase. 


3. Type the command ERASE, and the file name. For 
example, type: 


ERASE FILE1 


and press the Enter key to erase the file 
named FILE1 stored on the diskette in drive A. 


The DOS prompt (A > ) will re-appear, and you can 
enter another command, reload REPORT, or run 
another program. 


You can also erase all files on a diskette by entering the 
command ERASE, followed by the name of the drive 
containing the disk, then an asterisk, a dot, and 
another asterisk. For example, type: 


ERASE B:*.* 


and press the Enter key to erase all of the files 
from the diskette in drive B. 


Checking the Diskette Space 


Sometimes you will need to know how much space is 
available on a diskette. The CHKDSK command will 
give you that information. To find out how much 
space is available on a diskette, follow these steps: 


1. Exit from the REPORT program, and insert the 
DOS diskette in drive A. 


2. Insert the diskette you want to check into drive B. 


3. Enter the command CHKDSK, followed by the 
name of the drive containing the diskette, then 
press the Enter key. For example, type: 


CHKDSK B: 


and press the Enter key to display a list 
showing the total number of bytes on the 
diskette, the number of bytes used by your files, 
and the number of bytes still available. The list 
might look like this: 


160256 bytes total disk space 
49152 bytes in 3 user files 
111104 bytes available on disk 
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The DOS prompt (A >) will appear below the list. At 
this point, you can enter another command, reload 
REPORT, or run another program. 


If you have only one diskette drive, follow these 
instructions: 


1. Exit from the REPORT program, and insert the 
DOS diskette in the drive. 


2. Enter the command CHKDSK B.:, and press the 


Enter key. 
3. When DOS displays the message: 


Insert diskette for drive B 
and strike any key 


insert the diskette whose space you want to 
check, and press a key. 


Copying a File 


Often, you need to copy a pfs: file from one diskette 
to another. The COPY function will accomplish this 
task for you. 


To copy a file while using REPORT, follow these steps: 
For a two-drive system: 


1. Insert the REPORT diskette in drive A and exit 
from the REPORT program. 


2. When the DOS prompt (A >) appears, remove 
the REPORT diskette and insert the diskette that 
contains the file you want to copy. 


3. Insert the target diskette (the diskette you want to 
copy to) in drive B. 


4. Type the command COPY, followed by the name 
of the file you want to copy, then a space, then B: 
to indicate that you want the file copied onto the 
diskette in drive B. If you want the file to have a 
different name on the target diskette, enter that 
name after the B:. Press the Enter key to 
continue. 


For example, to copy a file named SALES from the 
diskette in drive A to the diskette in drive B, type: 


COPY SALES B: 


and press the Enter key. The file named SALES 
will be copied onto the diskette in drive B; the new file 
will also be named SALES. 


For a one-drive system: 


1. Insert the REPORT diskette in the drive, and exit 
from the REPORT program. 


2. When the DOS prompt (A>) appears, remove 
the REPORT diskette and replace it with the 
diskette that contains the file you want to copy. 


3. Type the command COPY, followed by the name 
of the file, a space, and the B:. Press the Enter 
key to continue. 


4. When the computer displays the message: 


Insert diskette for drive B and 
strike any key when ready 


insert the target diskette (the diskette you want to 
> copy to) in the drive and press any key. 
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5. When the computer displays the message: 


Insert the diskette for drive A and 
strike any key when ready 


insert the diskette that contains the file you want 
to copy and press any key 


6. When the DOS prompt (A >) reappears, the 
COPY function is complete. 


For example, to copy a file named SALES from one 
diskette to another, type: 


COPY SALES B: 


and press the Enter key. Switch diskettes as 
directed, and DOS will copy the SALES file onto the 
new diskette. 


Appendix D. The pfs:REPORT 
Setup Programs 


Sometimes you will need to give REPORT special 
i> instructions, depending on the exact configuration of 
, your IBM Personal Computer. These special 
instructions fall into three categories: 


1. You might need to send special characters to your 
printer before printing, especially if you want 
print enhancements such as 132-character 
compressed mode or bold type. See your printer 
manual for a description of the print modes 
available on your printer. 


2. If you have a serial printer, you will need to give 
information about its settings before REPORT can 
print correctly to that printer. 


3. You can change the diskette drive where REPORT 
assumes it will find your work diskette when 
sorting files printing. 


The REPORT program diskette includes two utility 
programs, SETUP and PRINTER, that you can use as 
needed to give REPORT these special instructions. 
This appendix describes these two programs. 


Sending Special Characters 


If your printer requires that you send a special 
character sequence, you will need to run the program 
named PRINTER each time you turn your printer on. 
Most printers including the IBM 80 CPS Matrix Printer, 
retain the setup characters until you turn the printer 
off, so you do not need to run the program each time 
o™ 
you load REPORT. 
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The following characters select the most valuable 
special printing modes of the IBM 80 CPS Matrix 
Printer: 


Ctrl1O compressed mode (132 characters/line) 
Esc E emphasized mode (bold print) 
Esc G double strike (good for carbon copies) 


The samples shown below were printed on the IBM 80 
CPS Matrix Printer using these modes, either alone or 
in combination. 


PRMD DOP Me Pred as PR IREP 
COMPRESSED 

COMPRESSED, DOUBLE STRIKE 
EMPHASIZED 

EMPHASIZED, DOUBLE STRIKE 


Note that it is not possible to use compressed mode 
and emphasized mode at the same time. 


To use the PRINTER program, follow these steps: 

1. If your computer is turned off, load DOS before 
beginning. Otherwise, exit from whatever 
program you are running. 

2. Put the REPORT program diskette in drive A. 

3. When the DOS prompt (A >) appears, type: 


PRINTER 


and press the Enter key to display the 
following screen: 


PRINTER SETUP 


This program allows you to send special characters to a printer. 


Turn your printer off and on, and enter its name below. 


© 1982 Software Publishing Corporation 


F10-continue 


D-3 


soxipusddy 


4. Turn your printer on, then enter the name of your 


printer. LPT1: is the name of the IBM 80 CPS 
Matrix Printer or another parallel printer; COM1: 
and AUX: are the possible names for a serial 
printer. Now press , and another screen 
appears: 


Enter printer setup characters. Press F10 when done. 
The characters will be sent to the printer. 
If you make a mistake, press F6 to escape from the program, 
and then run the program again. 


5. Enter the special characters you want to send to 
the printer. When you have finished, press the 
key. When the DOS prompt reappears, 
you can load REPORT or another program that 
you want to run. If you make a mistake entering 
the special characters, press and run the 
PRINTER program again. 


When you want to change the print mode, run 
PRINTER again and send the characters that set the 
desired mode(s) on. 


Example 


This example shows you how to print your 
information in double strike and in 132-character 
compressed mode on the IBM 80 CPS Matrix Printer. 
To do this, you must send special characters to the 
printer before you use the PRINT function. Use the 
PRINTER program to send the characters. 


First, exit from REPORT or whatever program you 
have been running. When the DOS prompt (A >) 
appears, put the REPORT program diskette in drive A, 


type: 
PRINTER 


and press the Enter key. When the instruction 
screen appears, turn your printer off and on as 
requested, leave LPT1: in the PRINTER NAME item 
(that selects the IBM 80 CPS Matrix Printer), and press 

. Next, the screen appears that asks you to enter 
the special characters: 


Enter printer setup characters. Press F10 when done. 
The characters will be sent to the printer. 

If you make a mistake, press F6 to escape from the program, 

and then run the program again. 
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Notice that the cursor is positioned next to the colon 
at the left-hand side of the screen. Now, to select 


compressed print mode, press O (press 
and, while holding it down, press the letter O ). Next, 


press (Esc) and then type: 
G 


to select double strike print mode. The screen should 
look like this: 


Enter printer setup characters. Press F10 when done. 
The characters will be sent to the printer. 
If you make a mistake, press F6 to escape from the program, 
and then run the program again. 


Ctri-0 
Escape 
G 


Oo 
oO 
Oo 
Oo 
oO 
oO 
oO 
oO 
O 


Now press to send those characters to the 
printer and return to DOS. When you see the A> 


prompt, type: 
REPORT 


and press the Enter key to run the REPORT 
program. Now you are ready to print your 
information. The next time you print a report, it will 


appear in both double strike and compressed modes. 


For example, one of the reports from the STAFF file 
might look like this: 


Compressed and Double Strike Print 
Job Title Phone Ext 


Woolf, Jases Personnel Clerk 
Bennet, Liza Secretary 

Woodhouse, Easa Purchasing Manager 
Thoason, John Company President 
Fawley, Susan Engineering Associate 
Sanchez, Enrico Design Engineer 
Peters, Marvin Technician 

Calvin, Curt Process Engineer 


0000 0 0 0 0 0 
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Note that to print 132 characters per line on the IBM 80 
CPS Matrix Printer you must print in compressed 
mode and change the PAGE WIDTH item on the 
Report Options Menu of REPORT to 132. 


Setting up a Serial Printer 
and the Work Drive 


If you have a serial printer or if you want to change the 
work drive used when sorting reports, you will need 
to run the program named SETUP the first time you 
run REPORT. The program stores the information you 
give it in a special file on the REPORT diskette, and 
uses it whenever you print a report. If you change to a 
different serial printer, or change the drives on your 
IBM Personal Computer, you will need to run the 
program again to give REPORT the new information. 


To run the SETUP program, follow these steps: 
1. If your computer is turned off, load DOS before 
beginning. Otherwise, exit from whatever 
program you have been using. You should see the 


A> prompt on the screen. 


2. Remove the write-protect tab from the REPORT 
diskette and place the diskette in drive A. 


4. Type the command: 
SETUP 


press the Enter key and a screen explaining 
the program will appear. 


4. Follow its instructions, then press to 


continue. A menu will come up next that looks 
like this: 


saxtpuaddy 
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F10-continue 


When you print a sorted report, REPORT assumes 
that it will find a work diskette in drive B that has 
enough free space. To be sure you have enough 
room, you should always keep a blank diskette in 
drive B. If for some reason you want to change 
the work drive so that REPORT will look in 
another drive for work space, you use this menu 
to make that change. Note that you need space on 
the work diskette at least equal to the size of the 
Dfs: file (see ““Checking the Diskette Space”’ in 
Appendix C.) 


Enter the name of the drive you want to use as a 
work drive in the WORK DRIVE item. For 
example, to set the work drive to drive A, type A:. 
If you are not using a serial printer, skip step 6 
and go to step 7. 


To set up the serial printer, enter the following 
information: 


SERIAL PRINTER NAME: enter COM1: or AUX: 


to identify the 
printer you have 


BAUD RATE: enter the baud rate 
setting for your 
printer 


Check your printer manual for the correct values 
for the other items on the menu. If you do not 
find the information, try the default settings (the 
values that appear on the screen) and see if the 
printer works properly. If not, press (Esc) to 
return to the REPORT Main Menu, then run the 
SETUP program again to experiment with other 
settings until you find the correct ones. If this is 
not successful, call your IBM Personal Computer 
dealer for help. 


When you are finished, press and REPORT 
will store the information on the program 
diskette, then return to DOS. 
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Notes 


Glossary 


backup copy: a diskette or file containing 
information that is a duplicate of the information on 
another diskette or file. Work with the copy and store 
the original in a safe place in case something happens 
to the information on the working copy. 


characters: symbols you may use to express 
information, including digits (0-9), letters, punctuation 
marks, and other special symbols. 


column calculations: report specifications that tell 
REPORT to total, count, or average the numbers ina 
column. 


cursor: the blinking underline displayed on the 
screen. It indicates where the next character typed will 
appear. 


default drive: REPORT searches the diskette located 
in the default drive to find any file names that you 
enter unless you specify another drive. The default 
drive is drive A unless you change it. See your DOS 
manual, “Specifying the Default Drive’ 
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default response: the response appearing next to a 
menu item before you make an entry. The default 
responses are entered by the program. You can enter a 
different response by typing over the default response. 


diskette: a removable magnetic recording medium 
used to store information. Diskettes can contain 
programs (such as the REPORT program diskette) or 
data (such as your pfs:files). Handle your diskettes 
carefully. 


diskette drive: The electronic device for large 
volume storage and retrieval of information. It is the 
machine in which you insert a diskette. 


file: a collection of forms that are of the same type. It 
contains the blank form you designed along with all 
the forms that you have filled in. REPORT also stores 
new headings and report specifications in the pfs: file. 


form: any combination of items in any order. You 
design a form, then use it to store and retrieve your 
information. 


format: the process of marking and arranging the 
storage space on a diskette. Formatting also erases any 
data stored on the diskette. 


item: the basic element of a form. An item consists of a 
name which is highlighted on the screen, followed by 
an area where you enter the information. 


load: the process of transferring a program froma 
diskette into the computer’s memory. 


menu: the list of functions that you can choose at a 
given time. The Main Menu appears when you first 
load the program. You can always return to the Main 
Menu by pressing the (Esc) key. 


numeric: description of information consisting of 
characters that have an arithmetic value, including 
numbers and decimal points. 


parallel printer: an IBM 80 CPS Matrix Printer or 
other printer connected to the IBM Monochrome 
Display and Parallel Printer Adapter (or the IBM 
Parallel Printer Adapter) 


prompt: a computer message which appears on the 
video screen to indicate that you should enter a 
response. 


report specifications: a filled in form that describes 
which items will appear as columns in a report, and 
their order. These also define any column calculations 
desired in the report. 


retrieve specifications: a filled in form that describes 
which forms to include in a report. 


serial printer: a printer connected to the IBM 
Asynchronous Communications Adapter. 


work drive: REPORT needs temporary work space on 
a diskette in order to sort a report. It looks for this free 
space on the diskette in the work drive. 


write-protect tab: a small strip of tape that covers the 
notch on the side of a diskette. No information can be 
written on the diskette as long as the write-protect tab 
covers the notch. Keep a write-protect tab over the 
notch on your REPORT program diskette. 
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Notes 
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A 


at-sign (@) 1-8 
average 1-21, 1-22 


B 


Backspace key 
8 


backup 
data file I-11, I-12 
program diskette I-7 
baud rate D-10 
bold print D-1, D-2 
byte length D-10 


C 


cancel function I-18 
CHKDSK command C-5 
column I-13, 1-14 
calculations 1-21 
formula 1-29, 1-30, 1-36 
heading 3-3 
width 3-3 
compressed print D-2 
configuration D-1 
Control key I-18 
COPY command C-6 
count 1-21, 1-22 
cursor G-] 
cursor movement keys 
1-19 


D 


data file protection I-11, 
I-12 

default drive 1-17 
default response G-| 
derived columns 1-29 
diskette care I-12 

DOS 1-2, I-6, 4-3, C-1 
double strike print D-2 
drive name I-17 


E 


eliminate sorting 1-15 
emphasized print D-2 
enter date 1-20 
erase C-] 
column headings 3-3 
page 2-4 
files C-4, C-5 
error messages I-12, A-] 
to A-9 
Escape (es) key I-18, 
1-20 
EXIT Pfs: REPORT 
function 4-1 


F 

file I-17 
file name extension 1-20, 
C-4 
form I-13 
format C-] 

diskettes C-] 

output 1-14 


full item match 1-5 
function keys I-19 


G 


getting started I-4 
“greater than” search 1-90 


H/I 


install REPORT 1-5 
item I-13 
item names I-14 


Index-l 


Index-2 


K/L 


keyboard usage I-18 

keyword reports 1-36 

“less than” search 1-9 

lines per page I-14 

list files C-2 

load the REPORT 
program 1-10, I-11 
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Main Menu _ [I-20 

modify 
column headings 3-3 
pre-defined report 
specification 2-4, 2-10 

multiple page forms 1-12 
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negative values 1-19 
next page I-19, 1-12 
non-numeric 

characters 1-19 
“not” match I-11 
Number Lock (3) 

key I-18 
numeric columns 1-19 
numeric item match 1-9 
numeric range match 1-10 


O 


one-drive system I-9, C-6 
order of calculations 1-25 


P 


Page Down key 
I-19, 1-12 

page size 1-13, 1-14 
Page Up key 1-19, 
1-12 


partial item match 1-6 
pre-defined report 1-13, 
2-1 


specification 1-13, 2-5 
PRE-DEFINE A 
REPORT function 2-1 
previous page I-19, 1-12 
PRINT A REPORT 
function I-1 


Print Screen key 
I-18, 1-20 
print 


carbon copies D-2 

to a diskette file 1-13 

to the console 2-11 

printer 1-13 

IBM 80 CPS Matrix 
I-20, D-1 

parallel D-4 

sending special 
characters 1-14, 1-20, 
D-| 

serial 1-20, D-1, D-9, 
D-11 
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remove 
files C-4, C-5 
report specification 2-5 
rename files C-1l, C-3 
report names 2-3 
Report Options 1-12 
REPOR. 1] setup 
programs D-|] 
report specifications 1-14, 
2-3 
required equipment I-4 
retrieve specifications 
1-20 
row I-13 
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save column headings 3-3 

SEARCH/UPDATE 
function 1-5 

serial number I-20 

SET NEW HEADINGS 
function 3-1 


shift key I-19 


sort I-13, 1-15, D-10 


Spaces in retrieve spec 1-5, 


1-6 

STAFF file 1-25, 2-5 
Start the REPORT 
program I-10 
subaverage 1-21, 1-22 
subcount 1-21, 1-22 
subtotal 1-21, 1-22 
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Tab key I-18 
title 1-13 
total 1-21 
two-drive system I-8 


U/V 


upper/lower case 
search 1-6 
video monitor I-4 


WwW 


wild card characters 1-6 
work drive D-1, D-9 
work space A-3, D-9 
write-protect tab I-5 
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The Personal Computer 


Reader’s Comment Form 


pfs: report 6936722 


Your comments assist us in improving the usefulness of 
our publication; they are an important part of the input 
used for revisions. 


IBM may use and distribute any of the information you 
supply in any way it believes appropriate without 
incurring any obligation whatever. You may, of course, 
continue to use the information you supply. 


Please do not use this form for technical questions 
regarding the IBM Personal Computer or programs for 
the IBM Personal Computer, or for requests for 
additional publications; this only delays the response. 
Instead, direct your inquiries or request to your 
Authorized IBM Personal Computer Dealer 


Comments: 


Tape Please do not staple Tape 
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Continued from inside front cover 


SOME STATES DO NOT ALLOW THE 
EXCLUSION OF IMPLIED 
WARRANTIES, SO THE ABOVE 
EXCLUSION MAY NOT APPLY TO 
YOU. THIS WARRANTY GIVES YOU 
SPECIFIC LEGAL RIGHTS AND YOU 
MAY ALSO HAVE OTHER RIGHTS 
WHICH VARY FROM STATE TO 
STATE. 


IBM does not warrant that the functions 
contained in the program will meet your 
requirements or that the operation of the 
program will be uninterrupted or error 
free. 


However, IBM warrants the diskette(s) or 
cassette(s) on which the program 1s fur- 
nished, to be free from defects in materials 
and workmanship under normal use for a 
period of ninety (90) days from the date of 
delivery to you as evidenced by a copy of 
your receipt. 


LIMITATIONS OF REMEDIES 


IBM’s entire liability and your exclusive 
remedy shall be: 


1. the replacement of any diskette(s) or 
cassette(s) not meeting IBM's “Limited 
Warranty” and which is returned to 
IBM or an authorized IBM PERSONAL 
COMPUTER dealer witha copy of your 
receipt, Or 

2. if IBM or the dealer is unable to deliver a 
replacement diskette(s) or cassette(s) 
which is free of defects in materials or 
workmanship, you may terminate this 
Agreement by returning the program 
and your money will be refunded. 


IN NO EVENT WILL IBM BE LIABLE 
TO YOU FOR ANY DAMAGES, 
INCLUDING ANY LOST PROFITS, 
LOST SAVINGS OR OTHER 
INCIDENTAL OR CONSEQUENTIAL 


DAMAGES ARISING OUT OF THE 
USE OR INABILITY TO USE SUCH 
PROGRAM EVEN IF IBM OR AN 
AUTHORIZED IBM PERSONAL 
COMPUTER DEALER HAS BEEN 
ADVISED OF THE POSSIBLITY OF 
SUCH DAMAGES, OR FOR ANY 
CLAIM BY ANY OTHER PARTY. 


SOME STATES DO NOT ALLOW THE 
LIMITATION OR EXCLUSION OF 
LIABILITY FOR INCIDENTAL OR 
CONSEQUENTIAL DAMAGES SO 
THE ABOVE LIMITATION OR 
EXCLUSION MAY NOT APPLY TO 
YOU. 


GENERAL 


You may not sublicense, assign or 
transfer the license or the program 
except as expressly provided in this 
Agreement. Any attempt otherwise to 
sublicense, assign or transfer any of the 
rights, duties or obligations hereunder is 
void. 


This Agreement will be governed by the 
laws of the State of Florida. 


Should you have any questions 
concerning this Agreement, you may 
contact IBM by writing to IBM Personal 
Computer, Sales and Service, P.O. Box 
1328-W, Boca Raton, Florida 33432. 


YOU ACKNOWLEDGE THAT YOU 
HAVE READ THIS AGREEMENT, 
UNDERSTAND IT AND AGREE TO 
BE BOUND BY ITS TERMS AND 
CONDITIONS. YOU FURTHER 
AGREE THAT IT IS THE COMPLETE 
AND EXCLUSIVE STATEMENT OF 
THE AGREEMENT BETWEEN US 
WHICH SUPERSEDES ANY 
PROPOSAL OR PRIOR AGREEMENT, 
ORAL OR WRITTEN, AND ANY 
OTHER COMMUNICATIONS 
BETWEEN US RELATING TO THE 
SUBJECT MATTER OF THIS 
AGREEMENT. 


Ta 
(i 
! 
HTT 
“il 
of" 


International Business Machines Corporation 


P.O. Box 1328-C 
Boca Raton, Florida 33432 


6936722 


Printed in United States of America 


UPDATE TO p/fs*:REPORT 


Dear IBM Customer, 


To use pfs:REPORT with DOS 2.00 you need a 
minimum of 128K bytes of memory. However, 
before you can use pfs:REPORT, you must follow the 
instructions on the following pages. The instructions 
are written for a two-drive system (pages O-1 
through O-2) and a one-drive system (pages O-3 
through O-4). 


Enclosed is a new appendix that contains 
instructions for using P/s:REPORT with the new 
version of DOS and the IBM fixed disk. Insert 
Appendix E in the pfs:REPORT manual after 
Appendix D. Also, insert page C-9 at the end of 

mam Appendix C. To reflect these changes, replace page 
vi of the book “Contents” with the revised pages vi 
and Vii. 


© Copyright 1982 by Software Publishing Corporation. 
© Copyright 1982 by International Business Machines Corporation 


Dfs: is a registered trademark of Software Publishing Corporation. 


1502438 


| 
a SarerE——ee | 


Contents 


INTRODUCTION ...................0.. I-1 
Part I. Getting Ready to Use REPORT ..... 1-4 
What You Need to Use REPORT ........ 1-4 
Making the REPORT Program Diskette 
DOUPLOAGUG 5c io $5455 E44 EO ORO 1-5 
For a two-drive system ........... I-5 
For a one-drive system ........... 1-6 
Making a Backup Copy of the REPORT 
PROCTUMEDGKCHC 44ac% eves cena ]-7 
FOr a TWO CLive SYSTEM ... 2.4. .4 eas 1-8 
Fora one drive system ........... 1-9 
Starting REPORT When the Computer 
22) a are eo ee ee ee ee I-10 
Starting REPORT When the Computer 
ICC noe 4 oe wb 4d ee ee eee He I-10 
Using REPORT With a One-Drive System . I-11 
Protecting Your pfs: Data Files ........ I-11 
Recommended Backup Procedure ...... I-12 
Part II. The pfs:REPORT Program ........ I-13 
What is pfs:REPORT? .............. I-13 
LSM DiS! VUES och obs ce Rte ew ne es I-17 
POCONOS bse crete he A oe Ree eR I-17 
The pfs:REPORT Menu ............. I-20 
SOUMMALY «seen aon ee AS SADE RO ESRD EHS I-21 
CHAPTER 1. PRINT AREPORT .......... 1-1 
Selecting PRINT AREPORT............. 1-3 
Step 1: Entering the Retrieve Specifications 1-5 
I, Fol Weit MaICn os cc eect tw wawe ee 1-5 
2. Parte emi MGC wc ec oh Re ee eee 1-6 
4. NumericlItem Match............. 1-9 
4. Numeric Range Match............ 1-10 
% “NOt SINC o outiwovvene ds taes 1-11 
Step 2: Choosing the Report Options ..... 1-13 
Step 3: Entering the Report Specification .. 1-14 
NUGMETIC COMMING vou 4 dies Fe ae Goes 1-19 
Peter NOM 64 6b edad ew een dwn te eens 1-20 
Reports with Column Calculations ...... 1-21 
ERAN 4440824426 beWee Re SE eee Hs 1-25 


vi 


Reports with Derived Columns ........ 1-29 


Pe adie ue aed ey en eee ba ees Pol 
Reports Using Keywords ............. 1-36 
SUMQUIATY 6c kb bb 4K Ow ee Ree PEER HHA ee 
CHAPTER 2. PRE-DEFINE A REPORT ..... 2-1 
Selecting the PRE-DEFINE A REPORT 
Function ........ 2.20... 00 eee ees 2-3 
Defining a Report Specification ......... 2-4 
Modifying an Existing Report Specification 2-4 
Removing a Report Specification ........ a5 


Example 1: Defining a Report Specification 2-5 
Example 2: Modifying an Existing Report 


SPECCHICANION. . ¢ cco 4 ek waaGaande Hex eS 2-10 
SUMIMAPY 4.44444 e nse eeaeudaceaeudurs 2-13 
CHAPTER 3. SET NEW HEADINGS ....... 1 
Selecting SET NEW HEADINGS .......... 3-3 
PXAMIDIS 6 ng coh 6446S 69 OOS Heke EES 3-4 
SUMMINATY 2 ahs ea eo ee ee hw ER OEE ee a7 
CHAPTER 4. EXIT pfs:REPORT .......... 4-] 
Selecting EXIT pfs:REPORT ............ 4-3 
SUUMIMATY 4a c obs ed eh bbws Cee Te EEE HES 4-3 
APPENDIX A. MESSAGES .............. A-1 
APPENDIX B. EXAMPLE FILE ........... B-1 
APPENDIX C. USEFUL DOS COMMANDS... C-1 

Formatting DiskcttesS...44...%504 e008 C-1 
Liga? VG: 6 44096 ebb e eee eo ke eo C-2 
Retain PINGS: .< «6s 5 cea 2 hea tres ae 4 C-3 
Erasing Files. oo oc. kha pe sedeodanad C-4 
Checking the Diskette Space «4 61 ccxce: C-5 
RADVCATIUG ge ecc esd dees eee anne C-6 
[nadine DOS i isiccteinsssdeoceeng neds C-9 
APPENDIX D. THE pfs: REPORT SETUP 
PROGRAMS 264 :504.8 4555846 bE Hae eS D-1 
Sending Special Characters ........... D-1 
Setting up a Serial Printer and the 
MORCDUIVG: ci neta deer ivan seen D-9 


APPENDIX E. p/fs:REPORT AND THE 


PEXED DISK. s4¢6¢20¢684ebeeesunse<atnade E-1 
Using pfs:REPORT with the IBM 
PikGG WICK. 2104540840 deerevess4459¢4s E-1 
Storing a Pfs:FILE on the 
“™ PIxGO SiG. 644645 u5.0ncseaerensedanaes E-1 
, Copying pfs:REPORT to the 
PIXCC DISK witveekogevesoneres.ae tase te E-2 
PErOr CONGIHIONS:. «4 c00s Kohden ba aeees E-3 
Running the pfs:REPORT Program 
front a. Fixed Disk si0cc evan pniceacnens E-4 
Changing Settings When Using the 
PSC DGGE 660 x ned gan taearoe o446444%s E-4 
GUOSSARY 640c43¢yaeecetgshesesiiesenad G-1 
TNE... £49445 246nn eed eacucuneneeses Index-1 


Notes: 


Loading DOS 


To load DOS on your Personal Computer: 


L. 


2 


Open the diskette drive door of Drive A. 


Holding your DOS diskette by the end with the 
label, insert it into the drive with the label 
facing up. 


When the diskette is in as far as it will go, close 
the diskette drive door. 


Position the System Unit Switch to ON, or if 
your computer is already on, hold down the Ctrl 
and Alt keys and at the same time press the Del 
key. 


On the screen, DOS will ask you for the date. 
Enter today’s date. If today were June 20, 1982, 
you would type 6-20-82. 


Press the Enter key. 


You will see a message prompting you to enter 
the time. Enter the current time. If the time 
were 8:45AM you would type 8:45 and if the 
time were 8:45PM you would type 20:45. 


Press the Enter key. 


You should see the following prompt on the 
screen: 


A> 


DOS is now loaded on your Personal Computer. 
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Appendix E. pfs:REPORT and the 
IBM Fixed Disk 


Using Pfs:REPORT with the IBM Fixed 
Disk 


You can use pfs:REPORT with the IBM fixed disk in 
two different ways. First, you can store your data files 
on the fixed disk, thus allowing larger files to be 
stored, and faster access to forms in the stored files. 
Second, you can copy the p/s:REPORT program to 
the fixed disk and then load it from there. This 
allows you to load the program faster, without using 
the program diskette. 


©» Storing a pfs:FILE on the Fixed Disk 


You can store a pfs:FILE on the fixed disk provided 
you include the drive identifier for the fixed disk as 
part of the file name. If you specify the fixed disk 
drive as the default drive, then it is not necessary to 
include the drive identifier as part of the file name. 
Note that your data file must be the same directory 
as your pfs:FILE program. 
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Copying P/fs:REPORT to the Fixed Disk 


Follow these steps to copy the pfs:REPORT program 
to the fixed disk: 


ie 


Insert the DOS diskette into drive A and turn on 
your IBM Personal Computer. Enter the date 
and time when the computer asks you to do so. 


When the DOS prompt appears, remove the 
DOS diskette and replace it with the 
Dfs:REPORT program diskette. 


Follow the instructions in Appendix D of the 
Dfs:REPORT manual called “Setting Up a Serial 
Printer and the Work Drive” to run the setup 
program. Change the work drive name to the 
drive name of your fixed disk. For example, if 
your fixed drive is drive C, then the work drive 
item on the setup menu should be drive C. 


If you have a serial printer, enter the correct 
values for the other items on the setup menu. 


Press the F10 key to complete the setup 
program. Then enter RTRANS in response to the 
DOS prompt. 


The “in use” lights will come on alternately as the 
program is copied from the diskette to the fixed 
disk. The copy is placed in the current directory. 
The DOS prompt reappears when the copy is 
complete. 


If you have more than one fixed disk, the copy will 
be made to the drive whose name is last in the 
alphabet. For example, if two drives are named C and 
D, the copy will automatically be made to drive D. 


& 


Error Conditions 


The following error conditions might occur during 
the copy procedure. 


™ Message Explanation Corrective Action 
CAN’T COPY Your program Try the copy 
PROGRAM FILE diskette has been procedure with 
damaged. the backup copy 
of the program 
diskette. 


Your fixed disk is Copy to diskette 


improperly any files on the 
formatted (also fixed disk. Then 
applies to the reformat the fixed 
CREATE disk, and try the 
message ). copy procedure 
again. 
)  CAN’T CREATE Your current If you have 
PROGRAM FILE directory is full. unnecessary files 
in the current 
level directory, 
delete them and 
start the copy 
procedure again. 
NAME ERROR Possible DOS Reload DOS and 
error. start the copy 
procedure again. 
WRONG Cannot find the Make sure the 
VERSION fixed disk. your fixed disk is 
| roperl 
a properly 


connected, and 
that you are using 
the new DOS. 
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Running the p/fs:REPORT Program from 
a Fixed Disk 


To run the p/fs:REPORT program from a fixed disk, 
make sure that you have followed the instructions 
under “Copying pfs:REPORT to the Fixed Disk.” 
Then in response to the DOS prompt, type and enter 
the drive identifier for the fixed disk followed by the 
name of the program. For example, to run the File 
program from drive C, enter C:REPORT. If the 
default drive is C, you need only enter REPORT in 
response to the DOS prompt. 


Changing Settings When Using the Fixed 


Disk 


E4 


To change the work drive or the information stored 
for your serial printer after copying the pfs:REPORT 
program to the fixed disk, you need to insert the 
Dfs:REPORT program diskette into drive A and run 
the setup program from that diskette. Use the COPY 
command to copy the file named IBMSETUP.PFS 
from the diskette drive in A to the fixed disk. 


Preparing Your REPORT Program 
Diskettes — One-Drive System 


DOS 2.00 DOS is slightly larger than DOS version 
1.00 or 1.10. Due to the increased size, there is not 
enough space to put DOS on the REPORT program 
diskette. To make room on the REPORT program 
diskette, you need to remove a sample file called 
STAFF. You will copy STAFF to a separate blank 
diskette, then erase STAFF from the REPORT 
diskette. The following steps explain this procedure. 


1. Load DOS. (See page C-9 “Loading DOS” 
contained in this update package. ) 


2. Remove the DOS diskette from drive A. 


3. Remove the write-protect tab from the REPORT 
program diskette. 


Write-Protect 
Tab 


4. Insert the REPORT program diskette in drive A. 
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To copy STAFF to the blank diskette, type: 
COPY STAFF B: 
and press the Enter key. 


You will see the following message: 


Insert diskette for drive B: 
and strike any key when ready. 


Remove the REPORT diskette from drive A. 


Insert a blank formatted diskette in drive A. (See 
“Formatting Diskettes” in Appendix C of the 
Dfs:REPORT manual. ) 


Press any key. You will see the light come on 
drive A and the message: 


1 File(s) copied 
Remove the blank diskette from drive A. 
Insert the REPORT program diskette in drive A. 


To remove STAFF from the REPORT program 
diskette, type: 


ERASE STAFF 
and press the Enter key. 


STAFF is no longer on the REPORT diskette, but 
is on the blank diskette in drive B. You are ready 
to proceed to Part 1 of the Introduction 
“Getting Ready to Use REPORT” in the 
DPfs:REPORT manual. Also, refer to page I-6 for 
using a one-drive system. 


Note: When you make a backup copy of the 
REPORT diskette, STAFF will not be on the 
original or on the backup copy. 


Preparing Your REPORT Program 
Diskette — Two-Drive System 


DOS 2.00 is slightly larger than DOS Version 1.00 or 
1.10. Due to the increased size, there is not enough 
space to put DOS on the REPORT program diskette. 
To make room on the REPORT program diskette, 
you need to remove a sample file called STAFF. You 
will copy STAFF to a separate blank diskette, then 
erase STAFF from the REPORT diskette. The 
following steps explain this procedure. 


1. Load DOS. (See page C-9 “Loading DOS” 
~ contained in this update package. ) 


2. Insert a blank formatted diskette in drive B. (See 
“Formatting Diskettes” in Appendix C of the 
pfs:REPORT manual. ) 


3. Remove the DOS diskette from drive A. 


4. Remove the write-protect tab from the REPORT 
diskette. 


Write-protect 
Tab 
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Insert the REPORT program diskette in drive A. 


To copy STAFF to the blank diskette, type: 
COPY STAFF B: 
and press the Enter key. . 


You will see the light come on drive A, then Y 
drive B and the message: 


1 File(s) copied 


To remove STAFF from the REPORT program 
diskette, type: 


ERASE STAFF 
and press the Enter key. 


STAFF is no longer on your REPORT program 
diskette, but is on the blank diskette in drive B. 
You are ready to proceed to Part 1 of the 
Introduction “Getting Ready to Use REPORT” in 
the pfs:REPORT manual. 


Note: When you make a backup copy of the 
REPORT diskette, STAFF will not be on the 
original or on the backup copy. 


